mcpmon 0.1.4 → 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
@@ -104,12 +126,10 @@ jobs:
             target: linux-x64
           - os: macos-latest
             target: darwin-arm64
-          - os: macos-13
+          - os: macos-15-intel
             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/.pre-commit-config.yaml

@@ -0,0 +1,44 @@
+# ============================================================================
+# .pre-commit-config.yaml
+# Install: pip install pre-commit && pre-commit install
+# Run manually: pre-commit run --all-files
+# ============================================================================
+
+repos:
+  # -------------------------------------------------------------------------
+  # SECRET DETECTION
+  # -------------------------------------------------------------------------
+
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.18.1
+    hooks:
+      - id: gitleaks
+        name: Detect secrets with gitleaks
+
+  # -------------------------------------------------------------------------
+  # GENERAL
+  # -------------------------------------------------------------------------
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-toml
+      - id: check-added-large-files
+        args: ['--maxkb=500']
+      - id: detect-private-key
+      - id: detect-aws-credentials
+
+  # -------------------------------------------------------------------------
+  # PYTHON
+  # -------------------------------------------------------------------------
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.3.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

package/README.md

@@ -2,51 +2,115 @@
 
 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 |
+| `-v, --verbose` | Show file change details |
+| `--debug` | Show all debug output |
+| `-t, --timestamps` | Include timestamps in output |
+| `-l, --log-file <file>` | Also write logs to file |
 
-- `--watch, -w` - Directory to watch (default: current directory)
-- `--ext, -e` - File extensions to watch, comma-separated (default: py)
+### Logging Levels
 
-### Examples
+```
+--quiet       Only errors
+(default)     Start, stop, restart events + PID
+--verbose     + file change details
+--debug       + everything
+```
+
+## Examples
 
 ```bash
-# 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 crucible-mcp
-mcpmon --watch src/crucible/ -- crucible-mcp
+# With timestamps and log file
+mcpmon --timestamps --log-file mcpmon.log -- python server.py
+
+# Gateway mode - multiple servers
+mcpmon --config .mcpmon.yaml
+```
+
+### Sample Output
 
-# With sage-mcp
-mcpmon --watch ~/.sage/ --ext py,yaml -- sage-mcp
+```
+[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 my_server
+[mcpmon 16:08:54 pid:53411] Restart #1 complete
+[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
 {
@@ -59,9 +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
+4. Sends `notifications/tools/list_changed` notification
+5. Claude Code refreshes tool cache automatically
+
+### 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
+# Python
+pip install -e ".[dev]"
+pytest tests/ -v  # 42 tests
+
+# Bun/TypeScript
+bun test  # 16 tests
+```
+
+## License
+
+MIT

package/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running mcpmon as `python -m mcpmon`."""
+
+from mcpmon import main
+
+if __name__ == "__main__":
+    main()

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=="],
+  }
+}