使用说明

项目简介
- CC-Switch 提供一个本地化的 MCP（模型上下文协议）服务器端实现，聚合 Claude、Codex、Gemini 等供应商的服务器配置和上下文资源，能够管理资源、工具与提示词，并将统一的 MCP 数据结构存储在本地数据库中以便多设备同步和快速切换。
主要功能点
- 统一 MCP 数据结构与管理：将多应用的 MCP 配置统一到一个跨应用的结构，支持导入、导出、同步与回填。
- 资源与提示词管理：集中托管供应商的资源、提示词与技能，提供导入、备份、回滚等能力。
- 多应用支持与切换：同时支持 Claude、Codex、Gemini 三类应用，提供当前活跃供应商的本地维护与快速切换。
- 本地存储与 SSOT：使用 SQLite 为可同步的主数据源，JSON 作为设备级设置的辅助存储，确保离线场景的一致性。
- 安全与互操作性：设计包含对 MCP 服务器端的导入/回滚、配置校验、与 UI 层的数据同步机制，便于集成到本地 LLM 客户端工作流中。
- 的传输与渲染支持：在 MCP 层支持多种传输类型（stdio、http、sse）以及与工具链的无缝对接，便于扩展。
安装步骤
- 环境准备
  - 需要具备 Rust 开发环境和 Node.js/前端构建环境（本项目为混合应用，前端使用 React+TypeScript、后端为 Rust/Tauri）。
- 构建与运行
  - 克隆仓库后，进入项目根目录进行依赖安装与构建：
    - 安装前提工具：Rust、Node（以及 pnpm/npm）。
    - 构建前端：在前端目录执行相应包管理器命令进行安装与打包，例如 pnpm install; pnpm build。
    - 构建后端与桌面应用：执行 cargo build 或通过 TAURI 的构建流程进行打包。
服务器配置（给 MCP 客户端使用的配置示例，非运行时代码）
- 服务器配置示例（JSON，描述 MCP 服务器的元信息与实际命令）
- 服务器名称：Sample Claude MCP 服务器
- 启动命令示例：claude-server
- 参数示例：["--config", "/path/to/claude.json"]
- 配置字段（JSON 说明，不是代码块）：
  - id: "sample-claude"
  - name: "Sample Claude MCP Server"
  - server: { "type": "stdio", "command": "claude-server", "args": ["--config", "/path/to/claude.json"] }
  - apps: { "claude": true, "codex": false, "gemini": false }
  - description: "Sample MCP server for Claude"
  - homepage: "https://example.com"
  - docs: "https://docs.example"
  - tags: ["sample", "claude"] 注释说明
- server 字段中的 type 指示服务器实现类型，command 为启动该 MCP 服务的可执行文件，args 为启动参数。示例中仅用于展示，实际配置以仓库提供的默认证据为准。
- MCP 客户端在连接时至少需要具备 server 的启动信息（名称、命令及参数）以建立连接。
基本使用方法
- 打开程序后进入 MCP 面板
- 点击“添加服务器”使用内置模板或自定义配置
- 选择需要托管的应用（ Claude / Codex / Gemini），配置启动命令及参数
- 启用/禁用对应服务器以决定是否同步到应用客户端的 live 配置
- 使用导入/导出功能在不同设备间迁移 MCP 配置
- 如需在集成中使用 live 配置，请确保服务器正确执行并能向相应客户端返回标准化的 MCP 结构

关键词

信息