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 作为入口。
  • 基本使用方法

      1. 安装 Bun 环境(若未安装)并确保在系统路径中可用。
      1. 根据上述配置启动 MCP 服务器进程,例如使用 Bun 启动 memory-bank 的入口脚本。
      1. 客户端通过 MCP 协议向服务器发送请求(如读取资源、调用工具、获取 prompts 等),服务器返回标准的 JSON-RPC 响应。
      1. 如需扩展传输协议,可参照代码中的 StdioServerTransport,未来可替换为 SSE/WebSocket 等实现。
      1. 如要在 Claude Code 等平台中使用,参考仓库 README 的安装与 MCP 服务器注册流程,进行本地或全局注册。
  • 备注

    • 仓库内包含完整、可运行的 MCP 服务器实现示例,覆盖资源、工具、以及上下文相关的核心 MCP 功能,且附带丰富的单元测试与示例用例,便于开发者理解与扩展。

服务器信息