{"_id":"@codespring-app/install-mcp","_rev":"4-974d50dcef608c1e0caa74535ac521fb","name":"@codespring-app/install-mcp","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@codespring-app/install-mcp","version":"1.0.0","keywords":["mcp","codespring","cli","configuration","npx","claude","cursor","cline","roo","model-context-protocol"],"author":{"name":"CodeSpring"},"license":"MIT","_id":"@codespring-app/install-mcp@1.0.0","maintainers":[{"name":"codespring","email":"support@codespring.app"},{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"}],"homepage":"https://github.com/codespring/mcp-client-configurator#readme","bugs":{"url":"https://github.com/codespring/mcp-client-configurator/issues"},"os":["darwin","linux","win32"],"bin":{"install-mcp":"dist/cli.js"},"dist":{"shasum":"b13c9b978ca52d98ad86f609e771ad750cf759b3","tarball":"https://registry.npmjs.org/@codespring-app/install-mcp/-/install-mcp-1.0.0.tgz","fileCount":59,"integrity":"sha512-Shyz0fQUgmGrFoEeV6sUEGZ2YPLAskg7H4SvrpcPpJSLpatwP9nkslvyiDQAIoKTN9cWdQHwcAhWxcDfnlJShQ==","signatures":[{"sig":"MEUCIDIS9infaGlmTx98F69P6pG2JzrzmhpGvlIQMj/Rs0ssAiEAr/nNKb2gPiYDoqOZQM9ThHo90Fh0Qv5yQ6ERAT0i7OU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":243488},"main":"dist/cli.js","_from":"file:codespring-app-install-mcp-1.0.0.tgz","types":"dist/cli.d.ts","engines":{"node":">=14.0.0"},"scripts":{"dev":"ts-node src/cli.ts","build":"tsc","start":"node dist/cli.js","type-check":"tsc --noEmit","build:watch":"tsc --watch"},"_npmUser":{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"},"_resolved":"/tmp/2c6742e0b94abd2e9a0b8ce9f2e8fbff/codespring-app-install-mcp-1.0.0.tgz","_integrity":"sha512-Shyz0fQUgmGrFoEeV6sUEGZ2YPLAskg7H4SvrpcPpJSLpatwP9nkslvyiDQAIoKTN9cWdQHwcAhWxcDfnlJShQ==","repository":{"url":"git+https://github.com/codespring/mcp-client-configurator.git","type":"git"},"_npmVersion":"10.8.2","description":"NPX tool to automatically install and configure CodeSpring MCP server across different MCP clients","directories":{},"_nodeVersion":"20.19.4","dependencies":{"axios":"^1.11.0"},"preferGlobal":false,"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.2","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/install-mcp_1.0.0_1756397667261_0.23222634884084492","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@codespring-app/install-mcp","version":"1.0.1","keywords":["mcp","codespring","cli","configuration","npx","claude","cursor","cline","roo","model-context-protocol"],"author":{"name":"CodeSpring"},"license":"MIT","_id":"@codespring-app/install-mcp@1.0.1","maintainers":[{"name":"codespring","email":"support@codespring.app"},{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"}],"homepage":"https://github.com/codespring/mcp-client-configurator#readme","bugs":{"url":"https://github.com/codespring/mcp-client-configurator/issues"},"os":["darwin","linux","win32"],"bin":{"install-mcp":"dist/cli.js"},"dist":{"shasum":"87c703b67f563f149aedae4dbdb639a0022abe4d","tarball":"https://registry.npmjs.org/@codespring-app/install-mcp/-/install-mcp-1.0.1.tgz","fileCount":59,"integrity":"sha512-v7bJ5kaz7tuCFHvj6mt8KtNVpJvdGZVUYrPB7vFv8HZcERcOp3jzPZDKQxheGFz4dInB5Afirg0IwZ8gK+lvFg==","signatures":[{"sig":"MEYCIQC+2vKiwouUHf6MucR/ymRSF00O8TMj0FXvVGyRophL7AIhAOUe8C9mvD7sN1rO2rGeBSIExROiOr26mrl4UVrTrDgv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":243512},"main":"dist/cli.js","_from":"file:codespring-app-install-mcp-1.0.1.tgz","types":"dist/cli.d.ts","engines":{"node":">=14.0.0"},"scripts":{"dev":"ts-node src/cli.ts","build":"tsc && chmod +x dist/cli.js","start":"node dist/cli.js","type-check":"tsc --noEmit","build:watch":"tsc --watch"},"_npmUser":{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"},"_resolved":"/tmp/ae4fb8e857875faccbb243881d575e88/codespring-app-install-mcp-1.0.1.tgz","_integrity":"sha512-v7bJ5kaz7tuCFHvj6mt8KtNVpJvdGZVUYrPB7vFv8HZcERcOp3jzPZDKQxheGFz4dInB5Afirg0IwZ8gK+lvFg==","repository":{"url":"git+https://github.com/codespring/mcp-client-configurator.git","type":"git"},"_npmVersion":"10.8.2","description":"NPX tool to automatically install and configure CodeSpring MCP server across different MCP clients","directories":{},"_nodeVersion":"20.19.4","dependencies":{"axios":"^1.11.0"},"preferGlobal":false,"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.2","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/install-mcp_1.0.1_1756398063515_0.025460887282904077","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@codespring-app/install-mcp","version":"1.0.2","keywords":["mcp","codespring","cli","configuration","npx","claude","cursor","cline","roo","model-context-protocol"],"author":{"name":"CodeSpring"},"license":"MIT","_id":"@codespring-app/install-mcp@1.0.2","maintainers":[{"name":"codespring","email":"support@codespring.app"},{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"}],"homepage":"https://github.com/codespring/mcp-client-configurator#readme","bugs":{"url":"https://github.com/codespring/mcp-client-configurator/issues"},"os":["darwin","linux","win32"],"bin":{"install-mcp":"dist/cli.js"},"dist":{"shasum":"8f368a942e1b4c21567aa4673ac3aae6fc6cf1d3","tarball":"https://registry.npmjs.org/@codespring-app/install-mcp/-/install-mcp-1.0.2.tgz","fileCount":59,"integrity":"sha512-LYfAovB7pnwNcxkB9ZaArsNTV+U/uuPNM5so+2QI7p+y5kKoVDQdql9tWEoLImfrSVCPoJP2FQiGciyARygE1g==","signatures":[{"sig":"MEUCIHyeJvGIy1JEvqKOWtWpbbtjU9tVF4HYAUY7798Y7l1zAiEAzW7y5oqv00HvKCXmIemv//KTFGOkSzlCG3rc2ioal20=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":243487},"main":"dist/cli.js","_from":"file:codespring-app-install-mcp-1.0.2.tgz","types":"dist/cli.d.ts","engines":{"node":">=20.0.0"},"scripts":{"dev":"ts-node src/cli.ts","build":"tsc && chmod +x dist/cli.js","start":"node dist/cli.js","type-check":"tsc --noEmit","build:watch":"tsc --watch"},"_npmUser":{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"},"_resolved":"/tmp/e83d5cbce9570a7813ba0a3f370f3707/codespring-app-install-mcp-1.0.2.tgz","_integrity":"sha512-LYfAovB7pnwNcxkB9ZaArsNTV+U/uuPNM5so+2QI7p+y5kKoVDQdql9tWEoLImfrSVCPoJP2FQiGciyARygE1g==","repository":{"url":"git+https://github.com/codespring/mcp-client-configurator.git","type":"git"},"_npmVersion":"10.8.2","description":"NPX tool to automatically install and configure CodeSpring MCP server across different MCP clients","directories":{},"_nodeVersion":"20.19.4","dependencies":{"axios":"^1.11.0"},"preferGlobal":false,"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.2","@types/node":"^24.3.0"},"_npmOperationalInternal":{"tmp":"tmp/install-mcp_1.0.2_1756398756029_0.561927986935367","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@codespring-app/install-mcp","version":"1.0.3","description":"NPX tool to automatically install and configure CodeSpring MCP server across different MCP clients","main":"dist/cli.js","types":"dist/cli.d.ts","bin":{"install-mcp":"dist/cli.js"},"keywords":["mcp","codespring","cli","configuration","npx","claude","cursor","cline","roo","model-context-protocol"],"author":{"name":"CodeSpring"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/codespring/mcp-client-configurator.git"},"bugs":{"url":"https://github.com/codespring/mcp-client-configurator/issues"},"homepage":"https://github.com/codespring/mcp-client-configurator#readme","dependencies":{"axios":"^1.11.0"},"devDependencies":{"@types/node":"^24.3.0","ts-node":"^10.9.2","typescript":"^5.9.2"},"engines":{"node":">=20.0.0"},"preferGlobal":false,"os":["darwin","linux","win32"],"scripts":{"build":"tsc && chmod +x dist/cli.js","build:watch":"tsc --watch","dev":"ts-node src/cli.ts","start":"node dist/cli.js","type-check":"tsc --noEmit"},"_id":"@codespring-app/install-mcp@1.0.3","_integrity":"sha512-D85TaNH4mbI/gYNDfa4awAsbkCkYUB4tcj+TIYPy7oyDSVA4W9xd2hITuClM2AOVmTXs1rQ0LgZnW2bdvHq3PA==","_resolved":"/tmp/5f68deddf37dd01df1de838bceb4d185/codespring-app-install-mcp-1.0.3.tgz","_from":"file:codespring-app-install-mcp-1.0.3.tgz","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-D85TaNH4mbI/gYNDfa4awAsbkCkYUB4tcj+TIYPy7oyDSVA4W9xd2hITuClM2AOVmTXs1rQ0LgZnW2bdvHq3PA==","shasum":"68b51f8329f086ebf0adbd2fc328e6d9f3938982","tarball":"https://registry.npmjs.org/@codespring-app/install-mcp/-/install-mcp-1.0.3.tgz","fileCount":59,"unpackedSize":242641,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFYm8PwSMWw7HXZ9ZZM4spO8A3O2A6rxLFMV1Vj+e85+AiEA9/jJu+OzCsk6ekq9ljp/2m6wQYYNePh01aF5DtYPsmk="}]},"_npmUser":{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"},"directories":{},"maintainers":[{"name":"codespring","email":"support@codespring.app"},{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/install-mcp_1.0.3_1757263208570_0.5712377824885462"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-28T16:14:27.167Z","modified":"2025-09-07T16:40:09.305Z","1.0.0":"2025-08-28T16:14:27.514Z","1.0.1":"2025-08-28T16:21:03.698Z","1.0.2":"2025-08-28T16:32:36.290Z","1.0.3":"2025-09-07T16:40:08.769Z"},"bugs":{"url":"https://github.com/codespring/mcp-client-configurator/issues"},"author":{"name":"CodeSpring"},"license":"MIT","homepage":"https://github.com/codespring/mcp-client-configurator#readme","keywords":["mcp","codespring","cli","configuration","npx","claude","cursor","cline","roo","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/codespring/mcp-client-configurator.git"},"description":"NPX tool to automatically install and configure CodeSpring MCP server across different MCP clients","maintainers":[{"name":"codespring","email":"support@codespring.app"},{"name":"harshdoesdev","email":"harshdoesdev@gmail.com"}],"readme":"# CodeSpring MCP Client Installer\n\nA TypeScript-based NPX tool to automatically configure the CodeSpring MCP server across different MCP client applications with a single command.\n\n## Quick Start\n\n```bash\n# Configure Claude Desktop\nnpx codespring-mcp-config claude your-api-key\n\n# Configure with connection validation\nnpx codespring-mcp-config cursor your-api-key --validate\n\n# Configure with custom URL\nnpx codespring-mcp-config cline your-api-key --url https://custom.codespring.app/api/mcp\n```\n\n## Usage\n\n```\nnpx codespring-mcp-config <client> <api-key> [options]\n```\n\n### Arguments\n\n- **client** - MCP client name (`claude`, `cursor`, `cline`, `roo`)\n- **api-key** - Your CodeSpring API key\n\n### Options\n\n- `--url <url>` - Custom CodeSpring MCP URL (default: `https://codespring.app/api/mcp`)\n- `--validate` - Test connection after configuration\n- `--help` - Display help message\n\n## Examples\n\n### Basic Configuration\n\n```bash\n# Configure Claude Desktop\nnpx codespring-mcp-config claude sk-1234567890abcdef\n\n# Configure Cursor\nnpx codespring-mcp-config cursor sk-1234567890abcdef\n\n# Configure Cline (VS Code extension)\nnpx codespring-mcp-config cline sk-1234567890abcdef\n\n# Configure Roo Code\nnpx codespring-mcp-config roo sk-1234567890abcdef\n```\n\n### Advanced Configuration\n\n```bash\n# Validate connection after configuration\nnpx codespring-mcp-config claude sk-1234567890abcdef --validate\n\n# Use custom CodeSpring URL\nnpx codespring-mcp-config cursor sk-1234567890abcdef --url https://enterprise.codespring.app/api/mcp\n\n# Combine validation with custom URL\nnpx codespring-mcp-config cline sk-1234567890abcdef --url https://custom.url/mcp --validate\n```\n\n## Configuration Details\n\nThe tool automatically locates and updates the appropriate configuration file for each client:\n\n### Claude Desktop\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Cursor\n- **All platforms**: `~/.cursor/mcp.json`\n\n### Cline (VS Code)\n- **macOS**: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/mcp_settings.json`\n- **Windows**: `%APPDATA%\\Code\\User\\globalStorage\\saoudrizwan.claude-dev\\settings\\mcp_settings.json`\n- **Linux**: `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/mcp_settings.json`\n\n### Roo Code\n- **macOS**: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json`\n- **Windows**: `%APPDATA%\\Code\\User\\globalStorage\\rooveterinaryinc.roo-cline\\settings\\mcp_settings.json`\n- **Linux**: `~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json`\n\n## Generated Configuration\n\nThe tool adds the following configuration to your MCP client:\n\n```json\n{\n  \"mcpServers\": {\n    \"CodeSpring MCP\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://codespring.app/api/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Development\n\nThis project is built with TypeScript and provides comprehensive type safety throughout the codebase.\n\n### Prerequisites\n\n- **Node.js**: Version 20.0.0 or higher\n- **pnpm**: Version 9.0.0\n- **TypeScript**: Installed automatically as dev dependency\n\n### Development Setup\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/codespring/mcp-client-configurator.git\n   cd mcp-client-configurator\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   npm install\n   ```\n\n3. **Build the project**:\n   ```bash\n   npm run build\n   ```\n\n### Required GitHub Secrets\n\nTo enable automated npm publishing, configure the following secret in your GitHub repository:\n\n#### NPM_TOKEN\n- **Purpose**: Authentication for npm package publishing\n- **Type**: npm access token with publish permissions\n- **Setup**: \n  1. Generate token at [npmjs.com/settings/tokens](https://www.npmjs.com/settings/tokens)\n  2. Select \"Automation\" token type with publish permissions\n  3. Add as repository secret: Settings → Secrets and variables → Actions → New repository secret\n  4. Name: `NPM_TOKEN`, Value: your npm token\n\n**Security Notes:**\n- Token is never exposed in workflow logs\n- Publishing only allowed from main branch or release tags\n- Minimal required permissions (publish only)\n- Regular token rotation recommended\n\n### Workflow Status\n\nMonitor workflow status and history:\n- **CI Status**: View pull request checks and main branch validation\n- **Release Status**: Track npm publishing progress and results\n- **Workflow Runs**: Access detailed logs at Actions tab in GitHub repository\n","readmeFilename":"README.md"}