HealthReporting MCP 服务器
使用说明（简要可执行版）
- 项目简介 HealthReporting 是一个面向 LLM 客户端的 MCP 服务器实现，核心职责是以统一的 JSON-RPC 方式向客户端暴露资源（Resources）、工具（Tools）以及 Prompt 模板等能力，帮助 LLM 在对话中获取数据、调用外部功能和呈现自定义的提示模板。
- 主要功能点
- 资源管理与数据访问：提供对本地/云端银级数据的标准化访问，支撑上下文信息的加载与查询。
- 工具注册与执行：注册并暴露多种工具，允许 LLM 调用外部功能获取外部能力（如健康数据分析、跨表查询、告警等）。
- Prompt 模板定义与渲染：提供可定制的 Prompt 模板，用于驱动 LLM 的交互模式与上下文组织。
- JSON-RPC 通信协议：服务器通过 JSON-RPC 接收请求（读取资源、调用工具、获取 Prompt 等），并返回 JSON-RPC 响应或通知。
- 会话与能力声明：会话层次的上下文管理与能力对外宣告，便于客户端对接与权限控制。
- 多传输协议支持：设计初衷包含对 Stdio、SSE、WebSocket 等传输模式的支持，提升与不同环境的集成灵活性。
- 安装步骤（简化指引）
- 确保 Python 环境就绪（推荐 Python 3.x，虚拟环境可选）。
- 安装并在当前项目根目录下运行以安装依赖（如 Pip 安装方式或开发模式安装）。
- 启动 MCP 服务器（示例入口可能为 health_platform.mcp.server，或 python health_platform/mcp/server.py，具体入口请以项目实际实现为准）。
- 客户端配置对接，按照服务器的启动参数进行连接设置。
- 服务器配置（给 MCP 客户端使用的配置，JSON 形式描述，含 server name、command、args 等）
{
"server_name": "HealthReporting MCP Server",
"command": ["python", "-m", "health_platform.mcp.server"],
"args": [
{"name": "host", "value": "0.0.0.0"},
{"name": "port", "value": "8000"},
{"name": "transport", "value": "websocket,sse,stdio"} // 同时启用多种传输模式以提高兼容性
]
}
说明：
- server_name 指定 MCP 服务器的名称，便于客户端识别与日志关联。
- command 为启动服务器的命令（不包含具体实现细节，避免将实现细节暴露给客户端）。
- args 为启动参数集合，包含 host、port 与可选传输模式说明，实际参数可能随实现调整，请以仓库中 server.py/入口的实际支持项为准。
- 基本使用方法
- 启动服务器：在具备网络/终端访问权限的环境中执行上述入口命令（或等价的服务器启动命令）。
- 客户端对接：将 MCP 客户端的连接信息指向服务器地址与端口，使用 JSON-RPC 发送对 Resources、Tools、Prompts 的读取/执行/渲染请求。
- 资源与工具调用：LLM 客户端可以按需通过 JSON-RPC 请求读取资源、执行工具并获取结果，服务器负责会话上下文维护与能力协商。
- 会话层次管理与安全：服务器实现应包含会话管理与能力声明，确保多客户端并发访问下的资源隔离与安全性。
- 维护与扩展：按 MCP 规范新增 Resources、Tools、Prompts 时，需遵循契约（语义契约/YAML 指定的指标、业务规则等）并更新相应的能力声明。