使用说明 (Markdown 版)

项目简介
- Path402 MCP Server 是一个完整的 MCP 服务端实现，基于 @modelcontextprotocol/sdk 提供的 MCP 服务框架，向 LLM 客户端提供统一的数据访问、工具执行和提示渲染能力，并通过标准的 JSON-RPC 协议与客户端交互。默认支持标准输入输出(STDIO)传输模式，亦可通过 HTTP 传输接入。
主要功能点
- MCP 核心能力
  - 资源(Resource)管理：提供数据访问能力，资源可被 LLM 客户端读取与鉴权。
  - 工具(Tools)注册与执行：注册多个工具（如 path402_discover、path402_evaluate、path402_acquire、path402_wallet、path402_price_schedule、path402_serve、path402_economics 等），LLM 客户端可通过调用这些工具完成对外部能力的访问。
  - Prompt/模板渲染：支持将提示模板与结构化信息输出，便于 LLM 以结构化内容理解并呈现结果。
- 通信传输
  - 标准 MCP JSON-RPC 格式通信。
  - 支持 stdio 传输，便于在命令行直接运行。
  - HTTP/Streamable HTTP 传输：通过 HTTP 路径 /mcp 的接口暴露 MCP 服务，便于浏览器/远程客户端接入。
- 会话与能力声明
  - 自动注册与暴露一组用于发现、购买、钱包、价格表、服务等的工具。
  - 提供对话中需要的上下文能力声明和工具/资源的管理，支持多种传输协议。
- 模块化与扩展性
  - 将核心 MCP 服务与具体实现分离，方便将来扩展新的传输、工具或资源类型。
  - 具备输入校验、错误处理以及结构化输出的示例代码，便于集成到更多场景。
安装与运行
- 安装与启动请参考仓库内的快速启动说明，该 MCP 服务可以通过 npx path402 启动，默认使用 stdio 传输；也可通过环境变量 TRANSPORT=http 切换到 HTTP 传输模式。
- 在本地测试时，确保 Node.js 环境可用，执行 npm install/install 依赖后即可运行。
服务器配置（给 MCP 客户端使用的描述性信息，非代码块）
- 服务器名称：path402
- 启动命令（client 使用的最小必需信息，用于与 MCP 服务器建立连接）
  - command: "npx"
  - args: ["path402"]
  - env（可选，用于提供 API 地址与预算等默认参数）:
    - PATH402_API_URL: https://path402.com
    - PATH402_DEFAULT_BUDGET: "10000"
- 配置说明：以上配置用于 MCP 客户端在本地或集成环境中启动并连接至 Path402 MCP Server。客户端需要知道服务器名称、启动命令及其参数，以便通过 JSON-RPC 向服务器发出读取资源、调用工具、获取 Prompts 等请求。实际的客户端实现会根据 MCP 库的规范自动完成请求的组装与发送，这里仅给出一个准确的服务端对应信息以辅助集成。
- 备注：MCP 客户端本身并不需要服务器端的源码，只需要知道服务端应如何启动与接入即可。
基本使用方法
- 启动 MCP 服务器（STDIO）: 在命令行执行 npx path402，即可以标准输入输出模式启动服务。
- 启动 MCP 服务器（HTTP）: 设置环境变量 TRANSPORT=http，即可通过 HTTP 端点访问 MCP 服务，HTTP 传输将暴露 /mcp 路径用于 JSON-RPC 请求。
- 客户端接入流程概述
  - 客户端通过 MCP 标准 JSON-RPC 请求向服务器请求资源、执行工具、获取 Prompts 等。
  - 服务器返回标准的 JSON-RPC 响应或通知，包含结果数据、结构化内容等信息。
- 运行与调试要点
  - 确认网络端口、传输方式、以及所需的权限（如本地网络访问、端口可用性）。
  - 若需要使用 HTTP，请确保服务器在指定端口对外提供 /mcp 路径的访问。

Path402 MCP Server

服务器信息