mcpmon 0.3.0 → 1.0.0

package/.github/workflows/release.yml

@@ -1,6 +1,9 @@
 name: Release
 
 on:
+  push:
+    tags:
+      - 'v*'
   workflow_dispatch:
     inputs:
       bump:
@@ -14,26 +17,20 @@ on:
           - major
 
 jobs:
-  release:
+  # Only runs on workflow_dispatch - bumps version and creates tag
+  bump:
+    if: github.event_name == 'workflow_dispatch'
     runs-on: ubuntu-latest
     permissions:
       contents: write
-      id-token: write
-    outputs:
-      version: ${{ steps.bump.outputs.version }}
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
       - uses: actions/setup-node@v4
         with:
           node-version: '20'
-          # NOTE: No registry-url - npm OIDC trusted publishers require no auth token present
 
       - name: Get current version
         id: current
@@ -56,6 +53,7 @@ jobs:
           NEW_VERSION="$major.$minor.$patch"
           echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
           sed -i "s/version = \"$CURRENT_VERSION\"/version = \"$NEW_VERSION\"/" pyproject.toml
+          sed -i "s/__version__ = \"$CURRENT_VERSION\"/__version__ = \"$NEW_VERSION\"/" mcpmon/__init__.py || true
           npm version "$NEW_VERSION" --no-git-tag-version
 
       - name: Commit and tag
@@ -64,16 +62,40 @@ jobs:
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add pyproject.toml package.json
+          git add pyproject.toml package.json mcpmon/__init__.py
           git commit -m "(release): v$NEW_VERSION"
           git tag "v$NEW_VERSION"
           git push && git push --tags
 
+  # Runs on tag push - publishes to PyPI and npm
+  publish:
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Extract version from tag
+        id: version
+        run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
       - name: Create release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NEW_VERSION: ${{ steps.bump.outputs.version }}
-        run: gh release create "v$NEW_VERSION" --generate-notes
+          VERSION: ${{ steps.version.outputs.version }}
+        run: gh release create "v$VERSION" --generate-notes || true
 
       # Publish to PyPI
       - name: Install build
@@ -93,7 +115,7 @@ jobs:
         run: npm publish --provenance --access public
 
   build-binaries:
-    needs: release
+    needs: publish
     runs-on: ${{ matrix.os }}
     permissions:
       contents: write
@@ -108,8 +130,6 @@ jobs:
             target: darwin-x64
     steps:
       - uses: actions/checkout@v4
-        with:
-          ref: v${{ needs.release.outputs.version }}
 
       - uses: oven-sh/setup-bun@v2
         with:
@@ -123,6 +143,6 @@ jobs:
       - name: Upload to release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          VERSION: ${{ needs.release.outputs.version }}
+          VERSION: ${{ needs.publish.outputs.version }}
           TARGET: ${{ matrix.target }}
         run: gh release upload "v$VERSION" "mcpmon-$TARGET" --clobber

package/README.md

@@ -2,31 +2,67 @@
 
 Hot reload for MCP servers. Like nodemon, but for MCP.
 
+## Features
+
+- **Hot reload** - Restart server on file changes
+- **Tool refresh** - Sends `notifications/tools/list_changed` so Claude Code sees new tools without session restart
+- **Gateway mode** - Aggregate multiple MCP servers behind one gateway
+- **Dual implementation** - Python and Bun/TypeScript with full feature parity
+
 ## Install
 
 ```bash
-# Bun (recommended)
-bunx mcpmon
+# Python
+pip install mcpmon
 
-# Or install globally
-bun install -g mcpmon
+# Bun (no install needed)
+bunx mcpmon
 
-# Python alternative
-pip install mcpmon
+# npm
+npm install -g mcpmon
 
 # Or download binary from GitHub releases (no dependencies)
 ```
 
 ## Usage
 
+### Single Server Mode
+
 ```bash
 mcpmon --watch src/ -- python -m my_mcp_server
 ```
 
-### Options
+### Gateway Mode (Multi-Server)
+
+```bash
+mcpmon --config .mcpmon.yaml
+```
+
+```yaml
+# .mcpmon.yaml
+servers:
+  sage:
+    command: sage-mcp
+    watch: ~/.sage/src/
+
+  crucible:
+    command: crucible-mcp
+    watch: ~/crucible/src/
+
+  my-server:
+    command: python
+    args: ["-m", "my_server"]
+    watch: ./src/
+    extensions: py,json
+```
+
+Gateway aggregates tools with prefixes: `sage__recall`, `crucible__review`, etc.
+
+## Options
 
 | Option | Description |
 |--------|-------------|
+| `-c, --config <file>` | Config file for multi-server gateway mode |
 | `-w, --watch <dir>` | Directory to watch (default: `.`) |
 | `-e, --ext <exts>` | Extensions to watch, comma-separated (default: `py`) |
 | `-q, --quiet` | Only show errors |
@@ -41,46 +77,40 @@ mcpmon --watch src/ -- python -m my_mcp_server
 --quiet       Only errors
 (default)     Start, stop, restart events + PID
 --verbose     + file change details
---debug       + everything (ignored files, spawning, exit codes)
+--debug       + everything
 ```
 
-### Examples
+## Examples
 
 ```bash
-# Basic usage - watch current directory for .py changes
+# Basic - watch current directory for .py changes
 mcpmon -- python server.py
 
-# Watch src/ for .py and .json changes
+# Watch specific directory and extensions
 mcpmon --watch src/ --ext py,json -- python -m myserver
 
-# With timestamps and verbose output
-mcpmon --timestamps --verbose -- python server.py
-
-# Log to file for debugging
-mcpmon --debug --log-file mcpmon.log -- python server.py
-
-# With crucible-mcp
-mcpmon --watch src/crucible/ -- crucible-mcp
+# With timestamps and log file
+mcpmon --timestamps --log-file mcpmon.log -- python server.py
 
-# With sage-mcp
-mcpmon --watch sage/ --ext py -- python -m sage.mcp_server
+# Gateway mode - multiple servers
+mcpmon --config .mcpmon.yaml
 ```
 
 ### Sample Output
 
 ```
-[mcpmon 16:08:50] Watching sage for .py changes
-[mcpmon 16:08:50 pid:53307] Started: python -m sage.mcp_server
+[mcpmon 16:08:50] Watching src/ for .py changes
+[mcpmon 16:08:50 pid:53307] Started: python -m my_server
+[mcpmon 16:08:54] File modified: tools.py
 [mcpmon 16:08:54 pid:53307] Restarting...
-[mcpmon 16:08:54 pid:53411] Started: python -m sage.mcp_server
+[mcpmon 16:08:54 pid:53411] Started: python -m my_server
 [mcpmon 16:08:54 pid:53411] Restart #1 complete
-[mcpmon 16:08:57] Received SIGTERM, shutting down...
-[mcpmon 16:08:57] Shutdown complete (restarts: 1)
+[mcpmon 16:08:54] Sent tools/list_changed notification
 ```
 
 ## MCP Config
 
-Use mcpmon in your `.mcp.json` for hot reload during development:
+### Single Server
 
 ```json
 {
@@ -93,30 +123,47 @@ Use mcpmon in your `.mcp.json` for hot reload during development:
 }
 ```
 
-## How it works
+### Gateway (Multiple Servers)
 
+```json
+{
+  "mcpServers": {
+    "gateway": {
+      "command": "mcpmon",
+      "args": ["--config", ".mcpmon.yaml"]
+    }
+  }
+}
+```
+
+## How It Works
+
+### Single Server Mode
 1. Starts your MCP server as a subprocess
 2. Watches specified directory for file changes
 3. On change: SIGTERM → wait 2s → SIGKILL → restart
-4. Claude Code automatically reconnects to the restarted server
-
-## Dual Implementation
-
-mcpmon ships as both:
-- **Bun/TypeScript** (`mcpmon.ts`) - Zero dependencies, fast startup
-- **Python** (`mcpmon.py`) - Uses `watchfiles` for robust file watching
+4. Sends `notifications/tools/list_changed` notification
+5. Claude Code refreshes tool cache automatically
 
-Both implementations have feature parity.
+### Gateway Mode
+1. Reads config file, starts all backend servers
+2. Aggregates tools from all backends (prefixed: `backend__tool`)
+3. Routes tool calls to correct backend
+4. Watches each backend's files independently
+5. Hot-reloads individual backends on change
+6. Hot-adds/removes backends when config changes
 
 ## Development
 
 ```bash
-# Install dev dependencies (Python)
+# Python
 pip install -e ".[dev]"
+pytest tests/ -v  # 42 tests
 
-# Run Python tests (27 tests)
-pytest tests/ -v
-
-# Run Bun/TS tests (12 tests)
-bun test
+# Bun/TypeScript
+bun test  # 16 tests
 ```
+
+## License
+
+MIT

package/bun.lock

@@ -0,0 +1,15 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "mcpmon",
+      "dependencies": {
+        "yaml": "^2.8.2",
+      },
+    },
+  },
+  "packages": {
+    "yaml": ["yaml@2.8.2", "", { "bin": { "yaml": "bin.mjs" } }, "sha512-mplynKqc1C2hTVYxd0PU2xQAc22TI1vShAYGksCCfxbn/dFwnHTNi1bvYsBTkhdUNtGIf5xNOg938rrSSYvS9A=="],
+  }
+}