使用说明
- 项目简介
- 该仓库实现了一个 MCP 服务器端框架,旨在为 LLM 客户端提供统一的上下文服务。核心能力包括托管资源(Resources)、注册与执行 Tools、以及定义和渲染 Prompts,服务器通过 JSON-RPC 与客户端交互,并具备会话管理和多传输协议支持。
- 主要功能点
- 资源管理:集中管理各类资源数据,客户端可按需读取。
- 工具注册与调用:注册可用工具,LLM 客户端可通过 MCP 调用外部功能。
- Prompts 管理与渲染:定义、渲染和切换模型提示模板,支持多应用分离的 Prompts 配置。
- MCP 服务器管理:统一的 MCP 服务器结构,支持从 Claude/Codex/Gemini 的 Live 配置/MCP 条目迁移到统一 MCP 结构,并在本地数据库(SQLite)中持久化。
- 会话与能力声明:会话管理、能力声明、以及对外暴露的服务能力(Resources、Tools、Prompts 等)。
- 数据传输协议:支持 stdio、http、SSE 等传输方式,与前端/LLM 客户端无缝衔接。
- 安全与扩展:提供并发、原子写入、回滚等机制,设计上便于扩展新的传输协议和数据源。
- 安装步骤
- 准备环境:需要 Rust 及相关工具链(仓库内的后端服务模块使用 Rust / Tauri 架构,前端为 React/TS,构建需按仓库的开发文档执行)。
- 构建与运行:在包含后端核心的工作路径下执行标准 Rust 项目构建与打包流程,生成可执行 MCP 服务器组件;运行后端服务以监听指定端口,等待 JSON-RPC 请求。
- 运行前置依赖与数据库初始化:首次启动会创建并初始化本地 SQLite 数据库,若已有历史配置会进行迁移。
- 服务器配置
- MCP 服务器启动命令及参数(示例,供 MCP 客户端连接使用):
- Claude(MCP 服务器示例,stdio 模式)
- server: { "type": "stdio", "command": "claude-server", "args": [] }
- 说明:以 claude-server 作为后端进程启动的 MCP 服务器,例如处理 Claude 相关资源与上下文。
- Codex(MCP 服务器示例,http 模式)
- server: { "type": "http", "url": "http://localhost:3000" }
- 说明:通过本地 HTTP 服务暴露 MCP,供 Codex 客户端调用。
- Gemini(MCP 服务器示例,SSE/嵌套传输)
- server: { "type": "stdio", "command": "gemini-server", "args": [] }
- 说明:Gemini 相关 MCP 服务示例,实际实现会根据 Gemini 客户端要求暴露合适的终端。
- Claude(MCP 服务器示例,stdio 模式)
- 配置说明
- 配置信息为 JSON 格式,包含 server 名称、command、args 等字段,用于 MCP 客户端在本地启动并连接到 MCP 服务器。
- MCP 客户端不需要额外的代码演示,仅需要具备读取 MCP 服务器的启动信息即可启动连接。
- MCP 服务器启动命令及参数(示例,供 MCP 客户端连接使用):
- 基本使用方法
- 启动与连接:通过提供的 JSON 配置启动 MCP 服务器进程,客户端通过指定的启动命令与参数连接并通过 JSON-RPC 与服务器通信读取 Resources、调用 Tools、获取 Prompts 等。
- 资源/工具/Prompts 的使用:客户端向 MCP 服务器发起标准的 JSON-RPC 请求,服务器返回相应的资源数据、可用工具的描述、或渲染后的 Prompt 内容。
- 会话与切换:服务器管理会话与当前活跃的 MCP 服务实例,支持跨应用(Claude/Codex/Gemini)的资源共享和上下文切换。
- 维护与扩展:数据库提供持久化、备份、迁移能力,便于在多设备/多应用场景下保持一致性和可追踪性。
信息
分类
AI与计算