My AI Resources MCP 服务端集合
Markdown 使用说明
-
项目概览
- 该仓库实现了基于 MCP 的服务端组件,核心目标是为 LLM 客户端提供统一的资源托管、工具执行和提示渲染能力,便于在 AI 工作流中管理上下文信息与功能。
-
主要特性
- MCP 服务器核心:使用 MCP 服务器框架,通过 JSON-RPC 与客户端通信,支持会话管理与能力声明。
- 资源与数据访问:内置资源管理能力,提供对各种资源(如 prompts、memory、配置等)的访问接口。
- 工具注册与调用:实现工具注册、输入校验、执行结果返回等能力,方便 LLM 调用外部功能。
- 提示与上下文:实现 Prompt/模板的定义与渲染,帮助 LLM 获取一致的交互模式。
- 多传输模式:示例服务器使用 StdioTransport,支持在不同环境下通过标准输入/输出进行通信;也支持未来扩展到 SSE/WebSocket 等传输。
-
安装与运行
- 该仓库使用 Bun 运行环境,包含可执行的 MCP 服务器脚本,直接以 Bun 运行对应的 TypeScript/JavaScript 文件即可启动服务器。
- 关键实现示例:Memory Bank MCP Server(memory-bank-mcp)和 Cursor Shortcuts MCP Server(cursor-shortcuts-mcp)。
- 运行示例(按需替换路径和执行方式):
- Memory Bank MCP 服务器:直接执行 memory-bank-mcp/src/index.ts(该文件以 bun 作为解释器头部,支持直接执行)。
- Cursor Shortcuts MCP 服务器:执行 cursor-shortcuts-mcp/src/server.ts,提供了对“推荐快捷键”和“更新快捷键”的工具。
- 注意:在实际生产环境中,请根据需求将 MCP 服务器放置于合适的网关或容器中,并配置相应的传输通道(如 stdio、SSE、WebSocket)。
-
服务器配置(给 MCP 客户端的启动信息)
- 服务器启动所需的最小信息为 server name、command 与 args,以便客户端能够启动并连接到对应的 MCP 服务器。
- 示例 JSON 配置(请按实际环境使用,不直接暴露源码实现,以下为格式示例): { "server_name": "memory-bank", "command": "bun", "args": ["memory-bank-mcp/src/index.ts"] }
- 上述配置说明:
- server_name:服务器在 MCP 客户端中的标识名称,与代码中实际服务器的 name 字段保持一致(Memory Bank 的服务器名称为 memory-bank)。
- command:启动服务器的命令,这里使用 bun 作为执行环境来运行 TypeScript/JavaScript 文件。
- args:要执行的脚本路径及参数,memory-bank-mcp 使用 memory-bank-mcp/src/index.ts 作为入口。
-
基本使用方法
-
- 安装 Bun 环境(若未安装)并确保在系统路径中可用。
-
- 根据上述配置启动 MCP 服务器进程,例如使用 Bun 启动 memory-bank 的入口脚本。
-
- 客户端通过 MCP 协议向服务器发送请求(如读取资源、调用工具、获取 prompts 等),服务器返回标准的 JSON-RPC 响应。
-
- 如需扩展传输协议,可参照代码中的 StdioServerTransport,未来可替换为 SSE/WebSocket 等实现。
-
- 如要在 Claude Code 等平台中使用,参考仓库 README 的安装与 MCP 服务器注册流程,进行本地或全局注册。
-
-
备注
- 仓库内包含完整、可运行的 MCP 服务器实现示例,覆盖资源、工具、以及上下文相关的核心 MCP 功能,且附带丰富的单元测试与示例用例,便于开发者理解与扩展。