使用说明（Markdown 格式）

• 项目简介

  • 这是一个完整的 MCP 服务器实现，核心功能包括管理资源、注册并执行工具，以及定义和渲染 Prompt 模板，目标是为 LLM 客户端提供安全、可扩展的上下文服务。

• 主要功能点

  • 资源与数据访问：托管并管理 API 资源和本地数据，便于 LLM 客户端读取与写入。
  • 工具注册与执行：注册多种工具，LLM 客户端可通过 JSON-RPC 调用外部功能与服务。
  • Prompt 模板渲染：支持按需渲染和渲染提示模板，满足多种交互模式。
  • 多传输协议支持：当前实现通过 STDIO 进行通信，未来可扩展为 SSE、WebSocket 等传输。
  • 安全与日志：对请求参数进行日志格式化，隐藏敏感信息，提供详细错误与执行日志。
  • 会话与能力声明：在服务器端进行会话管理与能力声明，确保对客户端请求的正确处理。
  • 本地化实现：结合 App Store 与 Google Play 的本地化数据，支持多语言上下文。

• 安装步骤

  • 克隆代码库并安装依赖。
  • 在项目根目录执行安装命令以安装依赖。
  • 使用命令启动 MCP 服务器（STDIO 模式）
  • MCP 客户端（Cursor、Claude Code、VS Code 等）按需配置连接到该服务器。

• 服务器配置（MCP 客户端连接配置 JSON，客户端无需理解服务器内部实现，仅需知道如何启动与连接）

  • server 名称: "pabal-mcp"
  • command: "node"
  • args: ["bin/pabal-mcp.js"]
  • transport: "stdio"
  • 备注: 该配置用于告诉 MCP 客户端如何启动并通过标准输入/输出与 MCP 服务器进行 JSON-RPC 通信。客户端不需要变更服务器端实现，直接按照该配置启动即可，确保在项目根目录执行命令时能找到 bin/pabal-mcp.js 的入口。

• 基本使用方法

  • 启动服务器后，使用支持 MCP 的客户端工具（如 Cursor、Claude Code、VS Code 插件等）连接到 STDIO 通道，发送标准的 JSON-RPC 请求来读取资源、调用工具、获取 Prompts 等。
  • 使用工具时，可以参考服务器端注册的工具信息与文档，向相应工具传递必要的参数。
  • 通过日志可以查看调用情况、请求参数安全处理和错误信息，便于调试与排错。