# cc-switch-mcp **Repository Path**: cj5035123/cc-switch-mcp ## Basic Information - **Project Name**: cc-switch-mcp - **Description**: No description available - **Primary Language**: C# - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-07-01 - **Last Updated**: 2026-07-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # cc-switch-mcp CC Switch 的 MCP 服务器,为 AI 编码助手提供模型供应商切换能力。 ## 概述 `cc-switch-mcp` 是 [CC Switch](https://github.com/cj5035123/cc-switch) 的配套 MCP(Model Context Protocol)服务。它通过标准 I/O 与 AI 编码助手(如 Claude Code、Claude Desktop 等)通信,允许助手直接查询和切换当前使用的模型供应商。 ## 功能 ### MCP 工具 | 工具 | 描述 | |------|------| | `get_providers` | 获取当前所有可用的模型供应商列表,含活动供应商和接管状态 | | `switch_provider` | 切换到指定模型供应商 | ### 切换模式 支持两种切换模式: - **普通模式** — 直接写入供应商配置到 Claude 配置文件,更新数据库记录 - **接管模式** — 通过代理接管流量,注入代理地址和模型别名,同时备份原始配置以便恢复 ### 核心技术特性 - **数据库驱动** — 通过 CC Switch 的 SQLite 数据库读取供应商配置、元数据等信息 - **实时配置管理** — 读取并修改 Claude Desktop/Code 的 `settings.json` / `claude.json` 配置文件 - **代理接管检测** — 双路径检测当前是否处于代理接管状态(数据库备份记录 + 配置文件占位符) - **JSON 深度合并/移除** — 支持供应商配置、公共配置片段的递归合并与差异移除 - **模型规范化** — 自动回填缺失的模型字段(Haiku/Sonnet/Opus),接管时映射为统一别名 - **原子写入** — 配置文件的写入采用临时文件 + rename 策略,防止半写状态 - **公共配置片段** — 支持跨供应商共享公共环境变量配置 ## 架构 ``` AI 编码助手 (Claude Code / Claude Desktop) │ │ MCP (stdio) ▼ ┌─────────────────┐ │ cc-switch-mcp │ │ │ │ McpTools │ ← MCP 工具定义 │ DatabaseService│ ← SQLite 数据访问 │ LiveConfigService│ ← Claude 配置文件读写 │ ProxyDetectionService│ ← 接管检测 │ TakeoverService │ ← 接管逻辑 └────────┬────────┘ │ ┌────┴────┐ │ SQLite │ │ (DB) │ └─────────┘ ``` ### 数据流 1. AI 编码助手通过 MCP 调用 `get_providers` 或 `switch_provider` 2. `McpTools` 接收请求,调用对应 Service 处理 3. `DatabaseService` 从 CC Switch 的 SQLite 数据库读取供应商信息 4. `LiveConfigService` 读取或写入 Claude 的配置文件(`~/.claude/settings.json`) 5. `ProxyDetectionService` 检测当前是否处于代理接管状态 6. `TakeoverService` 在接管模式下注入代理地址和模型别名 ## 安装 ### 前置条件 - .NET 8.0 SDK - [CC Switch](https://github.com/cj5035123/cc-switch) 已安装并至少启动一次(初始化数据库) ### 构建 ```bash dotnet publish src/CcSwitchMcp -c Release ``` ### 配置 确保 CC Switch 数据库文件位于 `~/.cc-switch/cc-switch.db`。该文件在首次启动 CC Switch 时自动创建。 在 AI 编码助手的 MCP 配置中添加: ```json { "mcpServers": { "cc-switch": { "command": "/path/to/cc-switch-mcp" } } } ``` ## 开发 ### 项目结构 ``` src/CcSwitchMcp/ ├── Program.cs # 入口点,MCP 服务器初始化 ├── McpTools.cs # MCP 工具定义(get_providers / switch_provider) ├── Models/ │ ├── GetProvidersResult.cs │ ├── ProviderInfo.cs │ └── SwitchResult.cs └── Services/ ├── DatabaseService.cs # SQLite 数据访问 ├── LiveConfigService.cs # Claude 配置文件实时操作 ├── ProxyDetectionService.cs # 代理接管检测 └── TakeoverService.cs # 接管模式逻辑 ``` ### 运行测试 ```bash dotnet test tests/CcSwitchMcp.Tests ``` ## 许可证 MIT