Merge branch 'main' of https://github.com/pathintegral-institute/mcpm.sh

Author: niechen

.github/workflows/release.yml

@@ -0,0 +1,32 @@
+on:
+  release:
+    types:
+      - published
+
+name: Release
+
+jobs:
+  pypi-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mcpm
+    permissions:
+      # IMPORTANT: this permission is mandatory for Trusted Publishing
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Install uv with caching
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+
+      - name: Build
+        run: uv build
+
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+ 

README.md

@@ -28,30 +28,30 @@ MCPM provides a comprehensive CLI built with Python's Click framework. Below are
 ### Basic Commands
 
 ```
-mcpm --help                  # Display help information and available commands
-mcpm --version               # Display the current version of MCPM
+mcpm --help                             # Display help information and available commands
+mcpm --version                          # Display the current version of MCPM
 ```
 
 ### Available Commands
 
 ```
-mcpm client                  # Show the current active MCP client
-mcpm client CLIENT_NAME      # Set a new active MCP client
-mcpm client --list           # List all supported MCP clients and their status
+mpcm add SERVER_NAME                     # Add an MCP server to the active client
+mcpm add SERVER_NAME --alias ALIAS_NAME  # Add an MCP server to the active client with a custom alias
 
-mcpm edit                    # View or edit the active MCP client's configuration file
+mcpm client                              # Show the current active MCP client
+mcpm client CLIENT_NAME                  # Set a new active MCP client
+mcpm client --list                       # List all supported MCP clients and their status
 
-mcpm list                    # List all installed MCP servers
+mcpm edit                                # View or edit the active MCP client's configuration file
 
-mcpm remove SERVER_NAME      # Remove an installed MCP server
+mcpm list                                # List all installed MCP servers
 
-mcpm server                  # Manage MCP server processes
-mcpm server start SERVER_NAME   # Start an MCP server
-mcpm server stop SERVER_NAME    # Stop an MCP server
-mcpm server restart SERVER_NAME # Restart an MCP server
-mcpm server status           # Show status of running MCP servers
+mcpm remove SERVER_NAME                  # Remove an installed MCP server
 
-mcpm toggle SERVER_NAME      # Toggle an MCP server on or off for a client
+mcpm stash SERVER_NAME                   # Temporarily disable an MCP server for a client
+mcpm pop SERVER_NAME                     # Re-enable an MCP server for a client
+
+mcpm inspect SERVER_NAME                 # Launch the MCPM Inspector UI to examine servers
 ```
 
 ### Registry
@@ -103,7 +103,7 @@ mcpm.sh/
 
 1. Clone the repository
    ```
-   git clone https://github.com/getmcp-xyz/mcpm.sh.git
+   git clone https://github.com/pathintegral-institute/mcpm.sh.git
    cd mcpm.sh
    ```
 
@@ -121,7 +121,7 @@ mcpm.sh/
 4. Run the CLI directly during development
    ```
    # Either use the installed package
-   mcp --help
+   mcpm --help
    
    # Or use the development script
    ./test_cli.py --help
@@ -136,7 +136,7 @@ mcpm.sh/
 
 - Use the src-based directory structure to prevent import confusion
 - Develop with an editable install using `uv pip install -e .`
-- Keep commands modular in the `src/mcp/commands/` directory
+- Keep commands modular in the `src/mcpm/commands/` directory
 - Add tests for new functionality in the `tests/` directory
 - Use the `test_cli.py` script for quick development testing
 
@@ -148,7 +148,7 @@ MCP uses a single source of truth pattern for version management to ensure consi
 #### Version Structure
 
 - The canonical version is defined in `version.py` at the project root
-- `src/mcp/__init__.py` imports this version
+- `src/mcpm/__init__.py` imports this version
 - `pyproject.toml` uses dynamic versioning to read from `version.py`
 - Git tags are created with the same version number prefixed with 'v' (e.g., v1.0.0)
 
@@ -170,6 +170,7 @@ When releasing a new version:
 3. Create a GitHub release matching the new version
 
 This process ensures that the version is consistent in all places: code, package metadata, and git tags.
+PyPI release is handled by the CI/CD pipeline and will be triggered automatically.
 
 ## License
 

pages/index.html

@@ -219,6 +219,48 @@
                 font-size: 1.2rem;
             }
         }
+        
+        .install-tabs {
+            margin: 2rem 0;
+        }
+        
+        .install-tabs .tabs {
+            display: flex;
+            border-bottom: 2px solid var(--accent-color);
+            margin-bottom: 0;
+        }
+        
+        .install-tabs .tab-button {
+            padding: 0.7rem 1.5rem;
+            border: none;
+            background-color: var(--bg-accent);
+            color: var(--text-primary);
+            cursor: pointer;
+            transition: all 0.2s ease;
+            margin-right: 4px;
+            font-weight: 500;
+        }
+        
+        .install-tabs .tab-button:hover {
+            background-color: rgba(92, 217, 81, 0.2);
+        }
+        
+        .install-tabs .tab-button.active {
+            background-color: var(--accent-color);
+            color: var(--text-secondary);
+        }
+        
+        .install-tabs .tab-content {
+            display: none;
+            padding: 1.5rem;
+            border: 1px solid var(--card-border);
+            border-top: none;
+            background-color: var(--bg-accent);
+        }
+        
+        .install-tabs .tab-content.active {
+            display: block;
+        }
     </style>
 </head>
 <body>
@@ -258,10 +300,36 @@ <h1>MCP Manager</h1>
 
         <div class="coming-soon">
             <h2>Quick Installation</h2>
-            <p>Install MCPM with a single command:</p>
-            <div class="code-block">
-                <code><span class="command-prompt">$</span> curl -sSL https://mcpm.sh/install | bash</code>
-                <button class="copy-button" data-command="curl -sSL https://mcpm.sh/install | bash"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg></button>
+            <div class="install-tabs">
+                <div class="tabs">
+                    <button class="tab-button active" data-tab="pipx">pipx</button>
+                    <button class="tab-button" data-tab="pip">pip</button>
+                    <button class="tab-button" data-tab="script">Shell</button>
+                </div>
+                
+                <div class="tab-content active" id="pipx-tab">
+                    <p>Install with pipx:</p>
+                    <div class="code-block">
+                        <code><span class="command-prompt">$</span> pipx install mcpm</code>
+                        <button class="copy-button" data-command="pipx install mcpm"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg></button>
+                    </div>
+                </div>
+                
+                <div class="tab-content" id="pip-tab">
+                    <p>Install with pip:</p>
+                    <div class="code-block">
+                        <code><span class="command-prompt">$</span> pip install mcpm</code>
+                        <button class="copy-button" data-command="pip install mcpm"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg></button>
+                    </div>
+                </div>
+                
+                <div class="tab-content" id="script-tab">
+                    <p>Install with a single command:</p>
+                    <div class="code-block">
+                        <code><span class="command-prompt">$</span> curl -sSL https://mcpm.sh/install | bash</code>
+                        <button class="copy-button" data-command="curl -sSL https://mcpm.sh/install | bash"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path></svg></button>
+                    </div>
+                </div>
             </div>
             <p>Model Context Protocol Manager (MCPM) is a Homebrew-like service for managing Model Context Protocol (MCP) servers across clients.</p>
         </div>
@@ -484,6 +552,25 @@ <h2>Supported Clients</h2>
                 // Fix for SVG animation in some browsers
                 setInterval(updateCursor, 100);
             }
+            
+            // Tabbed installation section
+            const tabButtons = document.querySelectorAll('.tab-button');
+            const tabContents = document.querySelectorAll('.tab-content');
+            
+            tabButtons.forEach(button => {
+                button.addEventListener('click', function() {
+                    const tabId = this.getAttribute('data-tab');
+                    const tabContent = document.getElementById(`${tabId}-tab`);
+                    
+                    // Remove active class from all buttons and contents
+                    tabButtons.forEach(button => button.classList.remove('active'));
+                    tabContents.forEach(content => content.classList.remove('active'));
+                    
+                    // Add active class to the selected button and content
+                    this.classList.add('active');
+                    tabContent.classList.add('active');
+                });
+            });
         });
     </script>
 </body>

pages/install

@@ -141,8 +141,8 @@ verify_installation() {
         echo
         echo -e "${DARK_GREEN}To get started with MCPM, try:${NC}"
         echo -e "  ${LIGHT_GREEN}mcpm --help${NC}         # Show available commands"
-        echo -e "  ${LIGHT_GREEN}mcpm list --available${NC} # List available MCP servers"
-        echo -e "  ${LIGHT_GREEN}mcpm install <server>${NC} # Install an MCP server"
+        echo -e "  ${LIGHT_GREEN}mcpm list${NC} # List local MCP servers"
+        echo -e "  ${LIGHT_GREEN}mcpm add <server>${NC} # Install an MCP server"
         echo
         echo -e "For more information, visit ${DARK_GREEN}https://mcpm.sh${NC}"
         echo

pyproject.toml

@@ -10,6 +10,8 @@ readme = "README.md"
 requires-python = ">=3.8"
 license = "MIT"
 authors = [{ name = "MCPM Contributors" }]
+maintainers = [{ name = "Path Integral Institute" }]
+keywords = ["MCPM", "MCP", "Model Context Protocol", "Claude Desktop", "Cursor", "Windsurf"]
 dependencies = [
     "click>=8.1.3",
     "rich>=12.0.0",
@@ -19,18 +21,14 @@ dependencies = [
     "jsonschema>=4.17.0",
 ]
 
+[project.urls]
+Homepage = "https://mcpm.sh"
+Repository = "https://github.com/pathintegral-institute/mcpm.sh"
+Issues = "https://github.com/pathintegral-institute/mcpm.sh/issues"
+
 [project.scripts]
 mcpm = "mcpm.cli:main"
 
-[tool.hatch.build]
-packages = ["src/mcpm"]
-
-[tool.hatch.build.targets.wheel]
-packages = ["src/mcpm"]
-
-[tool.hatch.build.targets.sdist]
-packages = ["src/mcpm"]
-
 [tool.hatch.version]
 path = "src/mcpm/version.py"
 

src/mcpm/version.py

@@ -1,3 +1,3 @@
 """Single source of truth for MCPM version."""
 
-__version__ = "1.0.0"
+__version__ = "1.0.2"