{"_id":"@codeninjapk/mcp-proxy","_rev":"2-7f4eab1fa2738062bd75c9eeb648583d","name":"@codeninjapk/mcp-proxy","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@codeninjapk/mcp-proxy","version":"1.0.0","keywords":["mcp","model-context-protocol","claude","proxy","remote","http","ai","assistant"],"author":{"name":"Your Company"},"license":"MIT","_id":"@codeninjapk/mcp-proxy@1.0.0","maintainers":[{"name":"madeonhyper","email":"imibrar@gmail.com"},{"name":"hariscodeninja","email":"haris.shahid@codeninjaconsulting.com"}],"homepage":"https://github.com/codeninjapk/mcp-proxy#readme","bugs":{"url":"https://github.com/codeninjapk/mcp-proxy/issues"},"bin":{"mcp-proxy":"bin/mcp-proxy.js","mcp-proxy-install":"bin/mcp-proxy.js","mcp-proxy-uninstall":"src/uninstall.js"},"dist":{"shasum":"9965af93590fca9b161d0e3592a33ae9dcd5bbef","tarball":"https://registry.npmjs.org/@codeninjapk/mcp-proxy/-/mcp-proxy-1.0.0.tgz","fileCount":8,"integrity":"sha512-5ezOscLSqaWy780g0qw4nZ4yuwBO7k+V1ieu7vMeMAGQhCZ1JAUNfUH0GUkI7nYWQ+FKwNO17XklIOutmS/JQA==","signatures":[{"sig":"MEUCIQDHcowAujvWY3hK1R0HjIO9yGrYWw6x40joSdtT2I71OQIgEtlH6+rZwpqOgigipjUjHVddkPmaEP1v9ehMSlK/5HY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24057},"main":"src/proxy-server.js","engines":{"node":">=16.0.0"},"scripts":{"postinstall":"node src/install.js"},"_npmUser":{"name":"hariscodeninja","email":"haris.shahid@codeninjaconsulting.com"},"repository":{"url":"git+https://github.com/codeninjapk/mcp-proxy.git","type":"git"},"_npmVersion":"10.9.3","description":"Universal MCP Proxy for Claude Desktop - Connect to any remote MCP server via HTTP","directories":{},"_nodeVersion":"22.19.0","dependencies":{"ora":"^5.4.1","chalk":"^4.1.2","prompts":"^2.4.2","commander":"^9.4.1","node-fetch":"^2.7.0","@modelcontextprotocol/sdk":"^1.22.0"},"preferGlobal":true,"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-proxy_1.0.0_1764775582654_0.5752765315545256","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@codeninjapk/mcp-proxy","version":"1.0.2","description":"Universal MCP Proxy for Claude Desktop - Connect to any remote MCP server via HTTP","main":"src/proxy-server.js","bin":{"mcp-proxy":"bin/mcp-proxy.js","mcp-proxy-install":"bin/mcp-proxy.js","mcp-proxy-uninstall":"src/uninstall.js"},"scripts":{"postinstall":"node src/install.js"},"keywords":["mcp","model-context-protocol","claude","proxy","remote","http","ai","assistant"],"author":{"name":"Your Company"},"license":"MIT","preferGlobal":true,"dependencies":{"@modelcontextprotocol/sdk":"^1.22.0","node-fetch":"^2.7.0","chalk":"^4.1.2","prompts":"^2.4.2","ora":"^5.4.1","commander":"^9.4.1"},"engines":{"node":">=16.0.0"},"repository":{"type":"git","url":"git+https://github.com/codeninjapk/mcp-proxy.git"},"_id":"@codeninjapk/mcp-proxy@1.0.2","bugs":{"url":"https://github.com/codeninjapk/mcp-proxy/issues"},"homepage":"https://github.com/codeninjapk/mcp-proxy#readme","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-FPoMN9a3Mv7Ixuvz+rfNn4BNx1o/eB7A1I4xC26nPYkUuaCrgCjTRJpKazMu8TbPYmCV6FaRjMqV0+XIedEoig==","shasum":"bd90b173f00f0d51137172b58ec11b36cb4ebe4f","tarball":"https://registry.npmjs.org/@codeninjapk/mcp-proxy/-/mcp-proxy-1.0.2.tgz","fileCount":8,"unpackedSize":22515,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCDra9+HniZq4xJ71/sIvscS2S9Rl4e+CkXboxNhkC0WwIhALSyIEEA1yeJ3vUh/SI3byx0F6JTFCK/PwXjGKD5x2p8"}]},"_npmUser":{"name":"hariscodeninja","email":"haris.shahid@codeninjaconsulting.com"},"directories":{},"maintainers":[{"name":"madeonhyper","email":"imibrar@gmail.com"},{"name":"hariscodeninja","email":"haris.shahid@codeninjaconsulting.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-proxy_1.0.2_1767265138058_0.725673118724357"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-03T15:26:22.479Z","modified":"2026-01-01T10:58:58.455Z","1.0.0":"2025-12-03T15:26:22.837Z","1.0.2":"2026-01-01T10:58:58.215Z"},"bugs":{"url":"https://github.com/codeninjapk/mcp-proxy/issues"},"author":{"name":"Your Company"},"license":"MIT","homepage":"https://github.com/codeninjapk/mcp-proxy#readme","keywords":["mcp","model-context-protocol","claude","proxy","remote","http","ai","assistant"],"repository":{"type":"git","url":"git+https://github.com/codeninjapk/mcp-proxy.git"},"description":"Universal MCP Proxy for Claude Desktop - Connect to any remote MCP server via HTTP","maintainers":[{"name":"madeonhyper","email":"imibrar@gmail.com"},{"name":"hariscodeninja","email":"haris.shahid@codeninjaconsulting.com"}],"readme":"# MCP Proxy\r\n\r\nUniversal proxy for connecting Claude Desktop to remote MCP servers via HTTP.\r\n\r\n## What is MCP?\r\n\r\nModel Context Protocol (MCP) allows AI assistants like Claude to access external tools and data sources. This proxy enables Claude Desktop to connect to remote MCP servers over HTTP/HTTPS.\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install -g @codeninjapk/mcp-proxy\r\n```\r\n\r\n## Setup\r\n\r\nRun the interactive setup wizard:\r\n\r\n```bash\r\nmcp-proxy install\r\n```\r\n\r\nYou'll be prompted for:\r\n\r\n- **Server name**: Identifier for Claude (e.g., `my-tools`, `company-api`)\r\n- **Remote server URL**: Your MCP server endpoint (e.g., `https://api.example.com`)\r\n- **Client ID**: Authentication credential\r\n- **Client Secret**: Authentication credential\r\n\r\n## Usage\r\n\r\nOnce installed:\r\n\r\n1. **Restart Claude Desktop**\r\n2. **Ask Claude**: \"What tools does [server-name] have?\"\r\n3. **Use your tools**: Claude can now access your remote MCP server!\r\n\r\n## Commands\r\n\r\n```bash\r\n# Install and configure\r\nmcp-proxy install\r\n\r\n# Reconfigure settings\r\nmcp-proxy configure\r\n\r\n# Test connection\r\nmcp-proxy test\r\n\r\n# Uninstall from Claude Desktop\r\nmcp-proxy uninstall\r\n\r\n# Complete removal\r\nnpm uninstall -g @codeninjapk/mcp-proxy\r\n```\r\n\r\n## How It Works\r\n\r\n```\r\nClaude Desktop (stdio) → MCP Proxy (local) → Your Server (HTTP)\r\n```\r\n\r\nThe proxy runs locally and translates between:\r\n\r\n- **stdio** (Claude Desktop's protocol)\r\n- **HTTP/JSON-RPC** (your remote server)\r\n\r\n## Requirements\r\n\r\n- Node.js 16+\r\n- Claude Desktop\r\n- A remote MCP server with:\r\n  - JSON-RPC endpoint (`/mcp/rpc`)\r\n\r\n## Server Requirements\r\n\r\nYour remote server must implement:\r\n\r\n### 1. JSON-RPC Endpoint\r\n\r\n```\r\nPOST /mcp/rpc\r\nAuthorization: Bearer <token>\r\nContent-Type: application/json\r\n\r\n{\r\n  \"jsonrpc\": \"2.0\",\r\n  \"id\": 1,\r\n  \"method\": \"tools/list\",\r\n  \"params\": {}\r\n}\r\n```\r\n\r\nSupported methods:\r\n\r\n- `tools/list` - List available tools\r\n- `tools/call` - Execute a tool\r\n- `prompts/list` - List available prompts\r\n- `prompts/get` - Get a specific prompt\r\n\r\n## Configuration File\r\n\r\nLocation:\r\n\r\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\r\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\r\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\r\n\r\nExample:\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"my-server\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"/path/to/proxy-server.js\"],\r\n      \"env\": {\r\n        \"REMOTE_MCP_URL\": \"https://api.example.com\",\r\n        \"MCP_CLIENT_ID\": \"client-id\",\r\n        \"MCP_CLIENT_SECRET\": \"client-secret\",\r\n        \"MCP_SERVER_NAME\": \"my-server\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Troubleshooting\r\n\r\n### Connection Issues\r\n\r\n```bash\r\nmcp-proxy test\r\n```\r\n\r\n### View Logs\r\n\r\n- **Windows**: `%APPDATA%\\mcp-proxy.log`\r\n- **macOS/Linux**: `~/mcp-proxy.log`\r\n\r\n### Common Issues\r\n\r\n1. **\"Token request failed\"**\r\n\r\n   - Check server URL is correct\r\n   - Verify client credentials\r\n   - Ensure server is running\r\n\r\n2. **\"Claude doesn't see tools\"**\r\n\r\n   - Restart Claude Desktop\r\n   - Check config file location\r\n   - Review logs for errors\r\n\r\n3. **\"RPC failed\"**\r\n   - Verify `/mcp/rpc` endpoint exists\r\n   - Check server implements JSON-RPC correctly\r\n   - Review server logs\r\n\r\n## Support\r\n\r\n- Issues: https://github.com/codeninjapk/mcp-proxy/issues\r\n- Docs: https://github.com/codeninjapk/mcp-proxy/wiki\r\n- Email: support@codeninjapk.com\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}