CodeSpring MCP Client Installer

A TypeScript-based NPX tool to automatically configure the CodeSpring MCP server across different MCP client applications with a single command.

Quick Start

# Configure Claude Desktop
npx codespring-mcp-config claude your-api-key

# Configure with connection validation
npx codespring-mcp-config cursor your-api-key --validate

# Configure with custom URL
npx codespring-mcp-config cline your-api-key --url https://custom.codespring.app/api/mcp

Usage

npx codespring-mcp-config <client> <api-key> [options]

Arguments

• client - MCP client name (claude, cursor, cline, roo)
• api-key - Your CodeSpring API key

Options

• --url <url> - Custom CodeSpring MCP URL (default: https://codespring.app/api/mcp)
• --validate - Test connection after configuration
• --help - Display help message

Examples

Basic Configuration

# Configure Claude Desktop
npx codespring-mcp-config claude sk-1234567890abcdef

# Configure Cursor
npx codespring-mcp-config cursor sk-1234567890abcdef

# Configure Cline (VS Code extension)
npx codespring-mcp-config cline sk-1234567890abcdef

# Configure Roo Code
npx codespring-mcp-config roo sk-1234567890abcdef

Advanced Configuration

# Validate connection after configuration
npx codespring-mcp-config claude sk-1234567890abcdef --validate

# Use custom CodeSpring URL
npx codespring-mcp-config cursor sk-1234567890abcdef --url https://enterprise.codespring.app/api/mcp

# Combine validation with custom URL
npx codespring-mcp-config cline sk-1234567890abcdef --url https://custom.url/mcp --validate

Configuration Details

The tool automatically locates and updates the appropriate configuration file for each client:

Claude Desktop

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

• All platforms: ~/.cursor/mcp.json

Cline (VS Code)

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/mcp_settings.json

Roo Code

• macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
• Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json

Generated Configuration

The tool adds the following configuration to your MCP client:

{
  "mcpServers": {
    "CodeSpring MCP": {
      "type": "streamable-http",
      "url": "https://codespring.app/api/mcp",
      "headers": {
        "x-api-key": "your-api-key"
      }
    }
  }
}

Development

This project is built with TypeScript and provides comprehensive type safety throughout the codebase.

Prerequisites

• Node.js: Version 20.0.0 or higher
• pnpm: Version 9.0.0
• TypeScript: Installed automatically as dev dependency

Development Setup

1. Clone the repository:

   git clone https://github.com/codespring/mcp-client-configurator.git
   cd mcp-client-configurator

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Required GitHub Secrets

To enable automated npm publishing, configure the following secret in your GitHub repository:

NPM_TOKEN

• Purpose: Authentication for npm package publishing
• Type: npm access token with publish permissions
• Setup:
  1. Generate token at npmjs.com/settings/tokens
  2. Select "Automation" token type with publish permissions
  3. Add as repository secret: Settings → Secrets and variables → Actions → New repository secret
  4. Name: NPM_TOKEN, Value: your npm token

Security Notes:

• Token is never exposed in workflow logs
• Publishing only allowed from main branch or release tags
• Minimal required permissions (publish only)
• Regular token rotation recommended

Workflow Status

Monitor workflow status and history:

• CI Status: View pull request checks and main branch validation
• Release Status: Track npm publishing progress and results
• Workflow Runs: Access detailed logs at Actions tab in GitHub repository