使用背景与目标

• 该项目实现了基于 MCP 的服务器端组件，核心职责是为 LLM 客户端提供标准化的上下文服务，包括资源管理、工具注册与执行，以及 Prompt 模板的渲染与返回。通过 JSON-RPC 与客户端通信，支持多种传输形式，便于在不同应用场景中接入。

主要功能点

• MCP 服务器核心能力
  • 处理 MCP 请求/响应：实现对 MCP 标准请求（如 ListTools、CallTool 等）的处理，并返回标准化的 JSON-RPC 响应。
  • 资源与工具管理：托管和管理“资源”(Resources) 与“工具”(Tools)，支持数据访问和外部功能调用。
  • Prompt 模板定义与渲染：提供可自定义的 Prompt 模板，支持 LLM 交互模式，并可渲染输出以供后续使用。
• 多服务器与示例
  • 仓库中包含多个 MCP 服务器实现示例（如 miyabi-integration、gemini、discord-integration 等），可直接运行或作为模板扩展，用于不同场景（图片生成、社交通知、代码生成等）。
• 传输和扩展性
  • 服务器端以 MCP 框架为核心，理论上可通过 Stdio、WebSocket、SSE 等传输方式对接客户端，支持扩展与横向部署。

安装与运行

• 依赖与环境
  • 需安装 Node.js 18+ 及 MCP 相关依赖（仓库内含可直接运行的脚本，具体依赖可通过对应脚本的 package.json 安装）。
• 运行方式
  • 直接运行单独的 MCP 服务脚本，例如 node .claude/mcp-servers/miyabi-integration.js
  • 同时运行多个服务器以覆盖不同工具/场景（如 image generation、Discord 集成等）以提供更丰富的 MCP 服务端能力。
• 服务器对外入口
  • 每个 server 实现都暴露 MCP Server 实例并向外提供标准 MCP 服务能力，实际启动命令以对应脚本为准。

配置（MCP 客户端需要的连接信息、非服务端代码）

• MCP 客户端需要的连接信息示例（以 JSON 形式描述，供客户端配置信息参考；注意：以下为示例配置，具体字段和注释应以实际运行环境为准）： { "server": "miyabi-integration", "command": "node", "args": [".claude/mcp-servers/miyabi-integration.js"], "transport": "stdio" // 如有其他传输方式，请按实际实现配置 }
• 说明
  • server: MCP 服务器的名称，与代码中定义的服务器标识相符（如 miyabi-integration）。
  • command: 启动服务器所使用的执行命令。
  • args: 启动命令的参数数组，包含服务器脚本路径等必要信息。
  • transport: 指定传输协议（如 stdio、websocket、sse 等），若客户端支持其它传输，请按实际实现配置。
• 说明中的字段旨帮助 MCP 客户端建立连接，实际运行无需通过此处说明的代码实现客户端，仅在配置时参考使用。

基本使用方法

• 启动与对接
  • 启动 MCP 服务器脚本，例如 node .claude/mcp-servers/miyabi-integration.js
  • 使用 MCP 客户端通过 JSON-RPC 向服务器请求：读取资源、调用工具、获取 Prompt 等，服务器返回标准的 JSON-RPC 响应。
• 典型操作流程
  • 通过 ListTools 请求获取服务器注册的工具清单
  • 通过 CallTool 请求执行特定工具，并获取执行结果
  • 通过相应的资源接口访问数据、工具调用结果，以及通过 Prompts 模板获取渲染后的输出
• 监控与扩展
  • 如需扩展能力，可以在现有 MCP 服务器基础上新增资源类型、工具及模板，保持与 MCP 的接口兼容性。

备注

• 该仓库内的 MCP 服务器实现是以示例/模板形式提供，具体生产场景的落地应结合实际应用需求进行定制化开发、鉴权与安全性设计。