PromptWheel MCP 服务器

使用说明

• 项目简介
  • PromptWheel MCP 服务器是一套基于 MCP 的后端服务，负责管理资源、注册工具、定义和渲染 Prompt 模板，并通过 JSON-RPC 与 LLM 客户端进行安全、标准化的上下文交互。
  • 服务器核心能力包括：资源/数据访问、工具执行、Prompt 模板渲染，以及会话管理与能力声明。支持多种传输协议，适配不同的工作流需求（如 Stdio、SSE、WebSocket 等）。
• 主要功能点
  • 资源与数据托管：提供资源/数据的统一管理与对外访问能力。
  • 工具注册与执行：注册外部工具并允许 LLM 调用外部功能。
  • Prompt 渲染与模板：定义并渲染可定制的 Prompt 模板，支持多种交互模式。
  • JSON-RPC 通信：通过标准的 JSON-RPC 与客户端进行请求/响应与通知。
  • 会话与能力声明：服务器端维护会话状态、预算、阶段等信息，并向客户端暴露能力。
  • 多传输协议支持：为不同应用场景提供可选传输方式（如 StdIO、SSE、WebSocket）。
• 安装与运行
  • 该仓库包含完整的服务器实现代码，可直接通过 npm/yarn 安装并运行 MCP 服务端；常见运行方式为使用 MCP 客户端调用 npx @promptwheel/mcp 来启动服务端（默认以 stdio 传输）。
  • 运行时示例（需自行按环境安装 Node.js 18+、数据库等依赖）：
    • 安装并启动 MCP 服务端：npx @promptwheel/mcp
    • 服务器会读取项目根目录的 .promptwheel/state.sqlite 作为持久化存储，并对外提供 MCP 服务。
• 服务器配置（MCP 客户端配置需包含以下字段，以便与服务器建立连接）
  • server name: promptwheel
  • command: npx
  • args: ["@promptwheel/mcp"]
  • 说明：MCP 客户端需要提供连接 MCP 服务器的启动命令与参数，上述示例是基于仓库默认入口配置的标准做法，具体参数可按运行环境调整，客户端实现不属于本仓库的职责。
• 基本使用方法
  • 启动服务器后，客户端通过统一的 MCP JSON-RPC 协议与服务器交互，完成资源读取、工具调用、Prompt 获取等操作。
  • 客户端可以通过发起请求来获取资源、执行工具并渲染 Prompts，服务器负责会话管理、能力声明和安全隔离等。
  • 如需本地测试，可构建并运行示例客户端（测试用例及示例在仓库中提供，实际使用时请参考 MCP 客户端实现）。