PePeRS MCP Server

使用说明

  • 项目简介 PePeRS 提供一整套学术论文发现、分析、提取、验证、代码生成等微服务,以及一个独立的 MCP 服务器,用于向大语言模型客户端提供统一的上下文服务。MCP 服务器负责暴露“资源、工具、Prompt”等能力,并通过标准化的接口实现资源读取、工具执行和提示渲染,方便 LLM 客户端调用外部功能与获取上下文信息。

  • 主要功能点

    • 资源托管与数据访问:集中管理论文、公式、代码等资源及其元数据,提供一致的数据访问入口。
    • 工具注册与执行:暴露一组工具接口,LLM 客户端可通过 MCP 调用外部功能。
    • Prompt 模板定义与渲染:提供可定制的提示模板,用于引导 LLM 客户端进行对话、查询与任务执行。
    • 多传输协议支持:支持 HTTP、SSE 等传输方式,便于不同客户端和桌面应用的集成。
    • 会话与能力声明:支持会话管理、能力声明与安全可扩展的上下文服务框架。
    • 与其他服务的协作:MCP 服务器对接 Orchestrator、Discovery、Analyzer、Codegen 等微服务,提供端到端的工作流上下文。
  • 安装步骤

    • 选项:以独立 MCP 服务器运行为例,使用 PePeRS 提供的安装方式运行 MCP 服务器(standalone)。
    • 指令示例(无需框架性代码块,按步骤执行)
      1. 获取代码仓库并进入项目目录。
      2. 以独立 MCP 服务器方式启动:
        • 使用 arcade flavor 启动: pe pers-mcp --port 8776 --flavor arcade
        • 也可选择 plain flavor 以获得更简单的对话风格输出
    • 说明:默认端口和风格可通过环境变量配置,具体参考仓库提供的运行手册。
  • 服务器配置(MCP 客户端需要的配置示例,JSON 格式)

    • server name: PePeRS MCP Server
    • command: pe pers-mcp
    • args: ["--port=8776", "--flavor=arcade", "--transport=sse"] 注释:该配置用于 MCP 客户端(如 Claude Desktop/Cursor 等)连接到 MCP 服务器的元信息,包含服务器名称、启动命令以及传递给服务器的参数。客户端无需此配置的实现细节,但需要了解服务器的启动信息以建立连接。
  • 基本使用方法

    • 启动后,MCP 服务器将提供资源读取、工具调用与 Prompt 渲染等能力。LLM 客户端可通过 MCP 提供的 JSON-RPC/HTTP+SSE 接口发起请求,如读取资源、执行工具、获取与渲染 Prompts。
    • 常见用法包括:
      • 通过 MCP 提供的工具列表调用外部功能
      • 请求并渲染论文相关的 Prompts
      • 获取并组合资源上下文,实现面向 LLM 的上下文服务
    • 如需与 Claude Desktop、Cursor 等客户端集成,可使用 HTTP + SSE 的传输模式,确保会话管理和能力声明与 MCP 协议一致。
  • 运行与验证

    • 使用 standalone MCP 服务器选项运行后,可通过客户端向 MCP 服务器发起 JSON-RPC / SSE 形式的请求,验证资源读取、工具调用和 Prompt 获取等能力是否正常工作。

服务器信息