@myneurogym/mcp-claude-bridge

Claude Desktop stdio bridge for Neurogym MCP (POST /mcp on the API host).

Requires Node.js 18+.

Claude Desktop config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "neurogym-cms": {
      "command": "npx",
      "args": ["-y", "@myneurogym/mcp-claude-bridge@latest"],
      "env": {
        "NEUROGYM_MCP_URL": "https://stage.api.myinnercise.com",
        "NEUROGYM_MCP_EMAIL": "[email protected]",
        "NEUROGYM_MCP_PASSWORD": "your-password"
      }
    }
  }
}

For local API development, set NEUROGYM_MCP_URL to http://localhost:3000.

Optional env vars:

| Variable | Purpose | |----------|---------| | NEUROGYM_MCP_API_KEY | Server MCP_API_KEY when enabled | | NEUROGYM_MCP_DEBUG | Set to 1 for verbose stderr logs |

Restart Claude Desktop after editing the config.

Publish (maintainers)

One command after any bridge change (bumps patch version and publishes to npm):

cd packages/mcp-claude-bridge
npm run deploy

From repo root:

./packages/mcp-claude-bridge/scripts/publish.sh

Other bumps:

npm run deploy:minor   # 1.0.0 → 1.1.0
npm run deploy:major   # 1.0.0 → 2.0.0
./packages/mcp-claude-bridge/scripts/publish.sh --dry-run patch

One-time setup: npm login as a user with publish access to the @myneurogym org (private npm plan required).

When do users get the new version?

Claude Desktop starts the bridge as a new process on each app launch. Config uses @latest, so npx resolves the newest published version at that moment.

| Event | New version loads? | |-------|-------------------| | You run npm run deploy | On npm immediately | | User restarts Claude Desktop | Yes (next MCP start) | | User already has Claude open | No — until they quit and reopen | | User config pins a version (e.g. @1.0.0) | No — until config is updated |

Users do not need to re-copy config or replace files after you publish — only restart Claude Desktop (full quit, not just close the window).

Local development (monorepo)

cd packages/mcp-claude-bridge
npm install
node bin/neurogym-mcp-bridge.js

Or use backend/scripts/mcp-claude-bridge.mjs, which re-exports this package.