Baichuan MCP Servers - 医疗场景的 MCP 服务器集合
使用说明(Markdown格式)
-
项目简介
- 该仓库实现了一个完整的 MCP 服务器集合,包含核心 MCP 功能:资源托管与访问、工具注册与执行、以及 MCP Apps 界面的 Prompts/UI 渲染。通过 JSON-RPC 与客户端通信,支持多种传输协议(stdin、SSE、HTTP/Streamable、混合模式等),并提供会话管理与能力声明。
-
主要功能点
- MCP 核心协议实现:处理初始化、请求、通知与响应,基于 JSON-RPC 进行交互。
- 资源与工具管理:注册服务器资源、注册对话工具、文件工具(上传、列出、查询状态、删除)等,面向 LLM 客户端提供数据与外部功能。
- Prompts/UI 支持:提供 MCP Apps UI 资源并渲染对话结果、思考过程和证据引用等。
- 多传输模式支持:
- 标准输入输出(stdio)模式
- 旧版 SSE(Cursor 等客户端)模式
- Streamable HTTP(HTTP 请求/响应的流式传输)模式
- 混合模式,兼容以上多种传输
- 会话管理与安全:会话生命周期管理、Origin 白名单、协议版本校验、跨源资源共享等安全特性。
- 医学领域整合:以 Baichuan 医学模型为例,结合文件上传与文档问答能力,支持医疗场景的上下文服务。
-
安装步骤
- 获取代码并安装依赖:
- 通过 npm/yarn 安装仓库中的 MCP Server 包(若已发布为包,则按包管理器方式安装)。
- 安装依赖后即可进入运行阶段,具体步骤见安装文档中的快速使用说明。
- 获取代码并安装依赖:
-
服务器配置(MCP 客户端需要的最小配置信息,JSON 格式,描述服务器端信息与启动参数) 以下配置用于 MCP 客户端在启动时识别并连接到该 MCP 服务器。 { "serverName": "baixiaoying-mcp-server", "command": "npx", "args": ["-y", "@baichuan-ai/baixiaoying-mcp-server"], "env": { "BAICHUAN_API_KEY": "your-api-key-here", "BAICHUAN_TIMEOUT_MS": "120000" // 可选,单位为毫秒 } // 说明: // - serverName 对应 MCP 服务器的标识名称,客户端通过该名称识别要启动的服务器。 // - command 与 args 指定启动服务器的命令及参数(示例使用 npm/yarn 方式执行包)。 // - env 可以按需设置 API Key、超时等环境变量。 }
-
基本使用方法
- 安装与准备
- 将 BAICHUAN_API_KEY 设置为有效密钥(环境变量)。
- 选择传输模式(stdio、http、sse、hybrid)并按需启动服务器。
- 启动服务器(示例模式)
- stdio:直接运行服务器进程,输出日志表明已在 stdio 模式启动。
- http/sse/hybrid:指定对应传输参数后启动,服务器将监听指定端口与路径。
- 客户端连接
- MCP 客户端在配置中使用上面的 JSON 配置启动服务器实例,即可通过 MPC 协议与服务器实现交互。
- 使用场景
- 通过 baixiaoying_chat 等工具在对话中调用模型进行医学问答、文档问答等。
- 使用文件工具实现文档上传、状态查询、引用等能力,提升对话质量与可追溯性。
- 安装与准备
-
运行示例(简述)
- 启动方式与参数参考仓库提供的实现,具体命令请结合实际环境执行。
-
额外注意
- 服务器实现包含多传输模式的协调与会话管理,实际部署时请根据需求配置允许的 Origin、会话 TTL、协议版本等参数。