{"_id":"@bobmatnyc/mcp-desktop-gateway","_rev":"6-b767f6e3d38ecee9d319908ec16cfceb","name":"@bobmatnyc/mcp-desktop-gateway","dist-tags":{"latest":"1.3.1"},"versions":{"1.0.0":{"name":"@bobmatnyc/mcp-desktop-gateway","version":"1.0.0","keywords":["mcp","claude","ai","bridge","gateway","anthropic","connector"],"author":{"url":"Masa","name":"Robert","email":"bobmatnyc@users.noreply.github.com"},"license":"MIT","_id":"@bobmatnyc/mcp-desktop-gateway@1.0.0","maintainers":[{"name":"bobmatnyc-1m2","email":"bob@matsuoka.com"}],"homepage":"https://github.com/bobmatnyc/mcp-desktop-gateway#readme","bugs":{"url":"https://github.com/bobmatnyc/mcp-desktop-gateway/issues"},"bin":{"mcp-desktop-gateway":"lib/cli.js"},"dist":{"shasum":"aba8d71971c084f32b59d46211d765d856058536","tarball":"https://registry.npmjs.org/@bobmatnyc/mcp-desktop-gateway/-/mcp-desktop-gateway-1.0.0.tgz","fileCount":158,"integrity":"sha512-DQFRwsxzTsMMU+9ZvVLi4A4i3SENWpbJC/yhrsJuVc3sbTwKHeGnp1LotMdRwmxZmNnjDOnmxV/uXm9RBKMRRw==","signatures":[{"sig":"MEUCIHzdjzUKG2A8itxM0wW9OOAqHJYsczTK7V3aLTA1ILCQAiEA63jswUH/LrpnLmp+ALyWLNRSGvlFgCB3pK99pIucKE0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1485039},"main":"lib/cli.js","engines":{"node":">=16.0.0"},"gitHead":"40abdc77b1b748148ecb88f52dc1b1f68574683e","scripts":{"test":"python scripts/run_tests.py","setup":"node lib/cli.js setup","start":"node lib/cli.js","config":"node lib/cli.js config","prepack":"echo 'Preparing package for publish...'","test:local":"make test-mcp-local","postinstall":"node lib/cli.js setup","prepublishOnly":"npm run test:local"},"_npmUser":{"name":"bobmatnyc-1m2","email":"bob@matsuoka.com"},"repository":{"url":"git+https://github.com/bobmatnyc/mcp-desktop-gateway.git","type":"git"},"_npmVersion":"10.8.2","description":"Universal MCP Gateway for Claude Desktop - Python-based bridge with built-in connectors","directories":{},"_nodeVersion":"20.19.0","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/mcp-desktop-gateway_1.0.0_1750111890687_0.43795581309168385","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@bobmatnyc/mcp-desktop-gateway","version":"1.1.0","keywords":["mcp","claude","ai","bridge","gateway","anthropic","connector","prompt-training","langchain","machine-learning","automation"],"author":{"url":"Masa","name":"Robert","email":"bobmatnyc@users.noreply.github.com"},"license":"MIT","_id":"@bobmatnyc/mcp-desktop-gateway@1.1.0","maintainers":[{"name":"bobmatnyc-1m2","email":"bob@matsuoka.com"}],"homepage":"https://github.com/bobmatnyc/mcp-desktop-gateway#readme","bugs":{"url":"https://github.com/bobmatnyc/mcp-desktop-gateway/issues"},"bin":{"mcp-desktop-gateway":"lib/cli.js"},"dist":{"shasum":"e73ce0d1f1b361b170d868d238d7a197fba05c0b","tarball":"https://registry.npmjs.org/@bobmatnyc/mcp-desktop-gateway/-/mcp-desktop-gateway-1.1.0.tgz","fileCount":173,"integrity":"sha512-qcz0iO5nnlbW7SuXY+khd161COLnSXkfjzTOSXSFbG7xgewjli8ugX4bnASV7s0jHcDmiCj/456iprKNPnIIGA==","signatures":[{"sig":"MEUCIB9AgLoPFsyW1zpERhegOXqcapNcHW71vBxUnYTnm273AiEAw8pfl7k7O3sjJv8As36JspRGvp7/INUKmEgBDpjJO2Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1716017},"main":"lib/cli.js","engines":{"node":">=16.0.0"},"gitHead":"02b6cd708a2a31f64a6a7aee315d5eb19e2a4020","scripts":{"test":"python scripts/run_tests.py","setup":"node lib/cli.js setup","start":"node lib/cli.js","config":"node lib/cli.js config","prepack":"echo 'Preparing package for publish...'","test:local":"make test-mcp-local","postinstall":"node lib/cli.js setup","prepublishOnly":"npm run test:local"},"_npmUser":{"name":"bobmatnyc-1m2","actor":{"name":"bobmatnyc-1m2","type":"user","email":"bob@matsuoka.com"},"email":"bob@matsuoka.com"},"repository":{"url":"git+https://github.com/bobmatnyc/mcp-desktop-gateway.git","type":"git"},"_npmVersion":"10.8.2","description":"Universal MCP Gateway for Claude Desktop - Python-based bridge with built-in connectors and automatic prompt training","directories":{},"_nodeVersion":"20.19.0","dependencies":{},"_hasShrinkwrap":false,"devDependencies":{},"_npmOperationalInternal":{"tmp":"tmp/mcp-desktop-gateway_1.1.0_1750733781944_0.895528402548158","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@bobmatnyc/mcp-desktop-gateway","version":"1.2.0","keywords":["mcp","claude","ai","bridge","gateway","anthropic","connector","prompt-training","langchain","machine-learning","automation"],"author":{"url":"Masa","name":"Robert","email":"bobmatnyc@users.noreply.github.com"},"license":"MIT","_id":"@bobmatnyc/mcp-desktop-gateway@1.2.0","maintainers":[{"name":"bobmatnyc","email":"bob@matsuoka.com"}],"homepage":"https://github.com/bobmatnyc/mcp-desktop-gateway#readme","bugs":{"url":"https://github.com/bobmatnyc/mcp-desktop-gateway/issues"},"bin":{"mcp-desktop-gateway":"lib/cli.js"},"dist":{"shasum":"d25cbe6d10451832fa098ea2469785d3fdbc65d5","tarball":"https://registry.npmjs.org/@bobmatnyc/mcp-desktop-gateway/-/mcp-desktop-gateway-1.2.0.tgz","fileCount":197,"integrity":"sha512-J1VcjX2wsfCnBXKRE8CBPNTSlll9x9NTzxN/DnLg+Jp4SZTVyIfIdtWdOy64wGtTZ+T3OauUqJVQCeSfPw76+A==","signatures":[{"sig":"MEYCIQC6YIKXR7YTSRxdWRFZDKiKLCWD1n4ZjXK7cHMlqv+AGQIhAMrD3rakcmP2f0Zk3FYd+z0OGrJWjyZ5rdpYAZQBS1rn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2061740},"main":"lib/cli.js","engines":{"node":">=16.0.0"},"gitHead":"cf2a5dc8c01adb654eb3158a37976c1e479d1d12","scripts":{"test":"python scripts/run_tests.py","setup":"node lib/cli.js setup","start":"node lib/cli.js","config":"node lib/cli.js config","install":"echo 'Installing mcp-desktop-gateway...' && python3 -m pip install -r requirements.txt --quiet || echo 'Warning: Could not install Python dependencies'","prepack":"echo 'Preparing package for publish...'","test:local":"make test-mcp-local","postinstall":"node lib/cli.js setup"},"_npmUser":{"name":"bobmatnyc","actor":{"name":"bobmatnyc","type":"user","email":"bob@matsuoka.com"},"email":"bob@matsuoka.com"},"repository":{"url":"git+https://github.com/bobmatnyc/mcp-desktop-gateway.git","type":"git"},"_npmVersion":"10.8.2","description":"Universal MCP Gateway for Claude Desktop - Python-based bridge with built-in connectors and automatic prompt training","directories":{},"_nodeVersion":"20.19.0","dependencies":{"@vercel/kv":"^3.0.0"},"installConfig":{"pythonRequired":">=3.8","autoInstallDeps":true},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-desktop-gateway_1.2.0_1752083974306_0.34527124624748073","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@bobmatnyc/mcp-desktop-gateway","version":"1.3.0","keywords":["mcp","claude","ai","bridge","gateway","anthropic","connector","prompt-training","langchain","machine-learning","automation"],"author":{"url":"Masa","name":"Robert","email":"bobmatnyc@users.noreply.github.com"},"license":"MIT","_id":"@bobmatnyc/mcp-desktop-gateway@1.3.0","maintainers":[{"name":"bobmatnyc","email":"bob@matsuoka.com"}],"homepage":"https://github.com/bobmatnyc/mcp-desktop-gateway#readme","bugs":{"url":"https://github.com/bobmatnyc/mcp-desktop-gateway/issues"},"bin":{"mcp-desktop-gateway":"lib/cli.js"},"dist":{"shasum":"ae039c911679821e1d71be6db8960262da7a7db1","tarball":"https://registry.npmjs.org/@bobmatnyc/mcp-desktop-gateway/-/mcp-desktop-gateway-1.3.0.tgz","fileCount":200,"integrity":"sha512-roqiR5tmmxJINykJvW1+vAtyUkV/jaJujUqSN/z6mxOQaJtsYtgyLUfkwenytZOq9fStuO+vocL8VkmETObLfA==","signatures":[{"sig":"MEUCIQC8srHWicstdXuEkm5AdNvDpGYLhbJUmbpnTKih+J+KwAIgIABLZTi2Mf3hPjv+sKbbFOploTYzwUmF04AC/HPEOUI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2169973},"main":"lib/cli.js","engines":{"node":">=16.0.0"},"gitHead":"3732d2d056ba0c23a3e97f35237d3c0ecf4304b3","scripts":{"test":"python scripts/run_tests.py","setup":"node lib/cli.js setup","start":"node lib/cli.js","config":"node lib/cli.js config","prepack":"echo 'Preparing package for publish...'","configure":"node lib/cli.js configure","test:local":"make test-mcp-local","postinstall":"node lib/cli.js setup","prepublishOnly":"echo 'Skipping tests for publication - manual validation completed'"},"_npmUser":{"name":"bobmatnyc","email":"bob@matsuoka.com"},"repository":{"url":"git+https://github.com/bobmatnyc/mcp-desktop-gateway.git","type":"git"},"_npmVersion":"10.8.2","description":"Universal MCP Gateway for Claude Desktop - Python-based bridge with built-in connectors and automatic prompt training","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cheerio":"^1.0.0-rc.12","@vercel/kv":"^3.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-desktop-gateway_1.3.0_1752270692879_0.003746249082265951","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@bobmatnyc/mcp-desktop-gateway","version":"1.3.1","description":"Universal MCP Gateway for Claude Desktop - Python-based bridge with built-in connectors and automatic prompt training","author":{"name":"Robert","email":"bobmatnyc@users.noreply.github.com","url":"Masa"},"main":"lib/cli.js","bin":{"mcp-desktop-gateway":"lib/cli.js"},"scripts":{"postinstall":"node lib/cli.js setup","start":"node lib/cli.js","setup":"node lib/cli.js setup","config":"node lib/cli.js config","configure":"node lib/cli.js configure","test":"python scripts/run_tests.py","test:local":"make test-mcp-local","prepack":"echo 'Preparing package for publish...'","prepublishOnly":"echo 'Skipping tests for urgent patch release'"},"keywords":["mcp","claude","ai","bridge","gateway","anthropic","connector","prompt-training","langchain","machine-learning","automation"],"license":"MIT","dependencies":{"@vercel/kv":"^3.0.0","cheerio":"^1.0.0-rc.12"},"engines":{"node":">=16.0.0"},"repository":{"type":"git","url":"git+https://github.com/bobmatnyc/mcp-desktop-gateway.git"},"bugs":{"url":"https://github.com/bobmatnyc/mcp-desktop-gateway/issues"},"homepage":"https://github.com/bobmatnyc/mcp-desktop-gateway#readme","_id":"@bobmatnyc/mcp-desktop-gateway@1.3.1","gitHead":"9b7bc8d24797de83e0ffea549d204a11d56f3cdb","_nodeVersion":"20.19.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-KX7L4FArqBYDoE6m5Eo/GSegSQlc8FF6wgydsRBh/t+wwGSu7iRAUkZiWchU6Mf6JZrl0FDbPdzIyVQmrWj4vA==","shasum":"848e123cc493997a42fd10d7b15b2b26079d7210","tarball":"https://registry.npmjs.org/@bobmatnyc/mcp-desktop-gateway/-/mcp-desktop-gateway-1.3.1.tgz","fileCount":200,"unpackedSize":2171927,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICL0sFZokswdIwgmnfxx0nfkf4UDl5Z7MuDEMtWr0phPAiEAohtnYBGEuVVQgaAZ2qvLRx/9dQvVT1FyzW2J9uEQ/pI="}]},"_npmUser":{"name":"bobmatnyc","email":"bob@matsuoka.com"},"directories":{},"maintainers":[{"name":"bobmatnyc","email":"bob@matsuoka.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-desktop-gateway_1.3.1_1752272370159_0.5233530428332811"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-16T22:11:30.570Z","modified":"2025-07-11T22:19:30.596Z","1.0.0":"2025-06-16T22:11:31.056Z","1.1.0":"2025-06-24T02:56:22.158Z","1.2.0":"2025-07-09T17:59:34.539Z","1.3.0":"2025-07-11T21:51:33.079Z","1.3.1":"2025-07-11T22:19:30.404Z"},"bugs":{"url":"https://github.com/bobmatnyc/mcp-desktop-gateway/issues"},"author":{"name":"Robert","email":"bobmatnyc@users.noreply.github.com","url":"Masa"},"license":"MIT","homepage":"https://github.com/bobmatnyc/mcp-desktop-gateway#readme","keywords":["mcp","claude","ai","bridge","gateway","anthropic","connector","prompt-training","langchain","machine-learning","automation"],"repository":{"type":"git","url":"git+https://github.com/bobmatnyc/mcp-desktop-gateway.git"},"description":"Universal MCP Gateway for Claude Desktop - Python-based bridge with built-in connectors and automatic prompt training","maintainers":[{"name":"bobmatnyc","email":"bob@matsuoka.com"}],"readme":"# MCP Desktop Gateway\n\nUniversal MCP (Model Context Protocol) Gateway for Claude Desktop - a Python-based bridge with built-in tools for system automation.\n\n## Features\n\n- 🔧 **Built-in Connectors**: Shell commands, AppleScript automation, and more\n- 🌐 **Extensible Architecture**: Add custom connectors via HTTP API\n- 🚀 **Automatic Setup**: One-command installation with automatic Claude Desktop configuration\n- 🔐 **Security Features**: Command filtering, timeouts, and sandboxing\n- 📦 **Zero Config**: Works out of the box with intelligent configuration detection\n\n## Quick Start\n\n### 1. Install via NPM\n\n```bash\nnpm install -g @bobmatnyc/mcp-desktop-gateway\n```\n\nThis will:\n- Install the MCP Gateway CLI\n- Set up a Python virtual environment\n- Install all Python dependencies automatically\n- **Automatically configure Claude Desktop** with MCP Gateway\n\n### 2. Restart Claude Desktop\n\nThat's it! The installation automatically configures Claude Desktop for you.\n\nIf you need to reconfigure manually, use:\n\n```bash\nmcp-desktop-gateway config\n```\n\n### 3. Start Using\n\nThe gateway is now available with these built-in tools:\n\n#### Shell Tools\n- `execute_command` - Run shell commands safely\n- `list_directory` - Browse the filesystem\n- `get_system_info` - Get system information\n\n#### AppleScript Tools (macOS only)\n- `run_applescript` - Execute AppleScript code\n- `system_notification` - Show notifications\n- `control_app` - Control applications\n- `get_clipboard`/`set_clipboard` - Manage clipboard\n\n#### Gateway Tools\n- `list_connectors` - List active connectors\n- `gateway_health` - Check gateway status\n- `hello_world` - Test the connection\n\n## Usage Examples\n\nIn Claude Desktop, you can now:\n\n```\n// List files in current directory\nexecute_command(command=\"ls -la\")\n\n// Show a notification (macOS)\nsystem_notification(title=\"Task Complete\", message=\"Your build finished!\")\n\n// Get system information\nget_system_info()\n```\n\n## Advanced Usage\n\n### Custom Configuration\n\nCreate a `config/config.yaml` file:\n\n```yaml\nserver:\n  name: \"mcp-desktop-gateway\"\n  version: \"1.0.0\"\n  log_level: \"INFO\"\n\nconnectors:\n  - name: shell\n    enabled: true\n    config:\n      timeout: 30\n      working_directory: \"/Users/me/projects\"\n```\n\n### Adding Custom Connectors\n\nMCP Gateway supports external connectors via HTTP. See the [documentation](https://github.com/user/mcp-desktop-gateway) for details on creating custom connectors.\n\n## Troubleshooting\n\n### Python Not Found\n\nMCP Gateway requires Python 3.8+. Install it from:\n- macOS: `brew install python3`\n- Ubuntu/Debian: `sudo apt install python3 python3-pip python3-venv`\n- Windows: Download from [python.org](https://python.org)\n\n### Permission Errors\n\nIf you get permission errors during installation:\n\n```bash\nsudo npm install -g @bobmatnyc/mcp-desktop-gateway\n```\n\n### Gateway Not Connecting\n\n1. Check the logs: `~/Library/Logs/Claude/mcp-server-mcp-desktop-gateway.log`\n2. Verify Python path: `mcp-desktop-gateway setup`\n3. Test manually: `mcp-desktop-gateway`\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/user/mcp-desktop-gateway\ncd mcp-desktop-gateway\n\n# Install in development mode\nnpm install\nnpm run setup\n\n# Run tests\nnpm test\n```\n\n## License\n\nMIT - See LICENSE file for details\n\n## Contributing\n\nContributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## Support\n\n- 📖 [Documentation](https://github.com/user/mcp-desktop-gateway/wiki)\n- 🐛 [Issue Tracker](https://github.com/user/mcp-desktop-gateway/issues)\n- 💬 [Discussions](https://github.com/user/mcp-desktop-gateway/discussions)","readmeFilename":"README.npm.md"}