使用说明（Markdown 格式）

OpenPaean MCP 服务器

OpenPaean MCP 服务器是一个本地实现的 Model Context Protocol (MCP) 服务器，负责通过 MCP 协议向客户端提供资源数据、注册并执行工具，以及渲染与管理提示模板等能力。服务器通过标准的 MCP 请求/响应模式工作，支持向客户端暴露以下核心能力：

• 资源管理：列出资源、读取资源内容等
• 工具执行：列出可用工具、按名称执行工具并返回结果
• 资源/工具上下文：基于项目环境提供有 context 的数据供 LLM 使用

主要功能点

• ListResources：返回可用的资源集合，供 LLM 选择读取
• ReadResource：读取指定资源的内容并返回数据
• ListTools：返回可用的 MCP 工具清单
• CallTool：按名称调用工具，并返回执行结果
• 通过 stdio 传输与客户端通信，便于本地集成与调试
• 错误处理与调试日志，便于快速定位问题

安装与运行

• 安装依赖后在本地编译运行 MCP 服务，生成可执行的 MCP 服务进程
• 以 stdio 传输方式启动 MCP 服务，使得本地 MCP 客户端能够通过标准输入输出与服务器交互

服务器配置（给 MCP 客户端使用的配置示例，含 server 名称、启动命令和参数） { "mcpServers": { "paean_mcp_server": { "command": "node", "args": ["dist/mcp/server.js"] } // 说明： // - server 名称在 MCP 客户端用于标识该服务器 // - command/args 为启动 MCP 服务器所需的命令及参数（客户端不需要此信息） } }

基本使用方法

• 在本地准备好 MCP 服务器后，MCP 客户端需要在配置中指向该服务器的启动命令与参数，以建立连接
• 客户端连接成功后，可以通过 MCP 请求逐步获取资源、读取资源、列出工具、执行工具，获得 JSON/RPC 风格的响应
• 如需调试或排错，可通过启用调试日志检查调用路径与返回结果

注意事项

• MCP 服务需要环境具备运行所需的 Node/TS 构建环境
• 本实现以 stdio 传输为基础，便于本地开发和集成到 CLI 工具链中
• 服务器端实现了资源和工具的核心协议处理，确保与 MCP 客户端的交互符合标准

关键词 模型上下文协议, 本地资源管理, 工具执行, 上下文服务, AI上下文

分类ID 6