使用说明(Markdown格式):

  • 项目简介
    • 这是一个基于 MCP 的服务器实现,负责托管并管理资源(Resources)、注册并执行 Tools、定义与渲染 Prompts,并通过 MCP 协议与客户端进行通信,提供一致的 JSON-RPC 风格请求/响应。
  • 主要功能点
    • 资源管理:提供 remedies 列表、repertories 列表、materia medicas 列表,以及帮助文档等资源的读取。
    • 工具注册与执行:内置五个工具(如 search_repertory、search_materia_medica、get_remedy_info、list_available_repertories、list_available_materia_medicas),支持工具调用、结果结构化输出(content 与 structuredContent,符合 MCP 2025-06-18 规范)。
    • 提示模板与对话流程:提供分析、比较、以及演绎工作流等 Prompts 的注册与获取。
    • MCP 协议支持:以 MCP 规范的请求/响应格式进行交互,包含错误等安全信息的处理与输出模式。
    • 多传输与会话管理:实现基于标准输入输出(Stdio)的传输,以及潜在的 SSE/WebSocket 等扩展能力,具备会话与缓存机制、去重、以及错误处理。
  • 安装步骤
    • 安装依赖并构建源码后启动服务(通常通过 node dist/index.js 启动或使用 npx oorep-mcp 的方式启动)。
    • 运行过程中将输出日志,日志等级通过环境变量 OOREP_MCP_LOG_LEVEL 控制(如 info、debug、warn、error)。
  • 服务器配置
    • MCP 客户端在接入时需要配置启动指令以连接 MCP 服务器,以下提供一个示例描述信息,供集成使用方配置客户端启动命令。
    • 服务器启动配置(示例描述信息,非代码块):
      • serverName: oorep
      • command: npx
      • args: ["-y", "oorep-mcp"]
      • 环境变量示例(可选):OOREP_MCP_BASE_URL、OOREP_MCP_TIMEOUT_MS、OOREP_MCP_CACHE_TTL_MS、OOREP_MCP_LOG_LEVEL、OOREP_MCP_DEFAULT_REPERTORY、OOREP_MCP_DEFAULT_MATERIA_MEDICA
    • 实际使用时,请按您环境的部署方式将上述信息整理为 JSON 配置,并提供给 MCP 客户端进行连接配置(注:下面给出的是一个供参考的 JSON 结构,非代码片段,以便理解字段含义)。
    • 配置示例说明(JSON 结构描述,非代码块): { "serverName": "oorep", "command": "npx", "args": ["-y", "oorep-mcp"], "env": { "OOREP_MCP_BASE_URL": "https://www.oorep.com", "OOREP_MCP_TIMEOUT_MS": "30000", "OOREP_MCP_CACHE_TTL_MS": "300000", "OOREP_MCP_LOG_LEVEL": "info", "OOREP_MCP_DEFAULT_REPERTORY": "publicum", "OOREP_MCP_DEFAULT_MATERIA_MEDICA": "boericke" } }
  • 基本使用方法
    • 启动服务器后,向使用 MCP 的客户端提供统一的接口。
    • 客户端可以通过工具调用读取资源、执行工具、获取 Prompt 等,服务器将返回符合 MCP 规范的 JSON-RPC 响应,以及在需要时提供结构化内容以便后续处理。
    • 如需对接 Claude/Codex/Gemini 等,参照各自的集成指南将服务器作为 MCP 服务端注入到相应中间件即可。

信息

分类

AI与计算