🚀 fhir-mcp-server-medagentbench

这是一个基于 Python 的 MCP（MedAgentBench 通信协议）服务器，专为 MedAgentBench 环境设计，可模拟与 FHIR（快速医疗互操作性资源）API 的交互，无需实时 FHIR 端点即可测试 MedAgentBench 代理。

🚀 快速开始

本服务器可模拟与 FHIR API 的交互，无需向实际的 FHIR 服务器发送 HTTP 请求。它会拦截 MCP 请求中的 FHIR 操作，并返回该请求的文本表示，从而实现无需实时 FHIR 端点即可对 MedAgentBench 代理进行测试。

✨ 主要特性

• 实现 MCP 处理器：
  • list_resources：列出可用的模拟资源（当前为 CapabilityStatement）。
  • read_resource：模拟通过 URI 读取 FHIR 资源。
  • list_tools：列出可用的 FHIR 模拟工具。
  • call_tool：模拟执行 FHIR 操作：
    • search_fhir：模拟搜索 FHIR 资源。
    • read_fhir：模拟通过 URI 读取特定的 FHIR 资源。
    • create_fhir_resource：模拟创建新的 FHIR 资源。
• 使用 mcp - server 库：用于 MCP 通信。
• 使用 Poetry 管理：进行配置和打包。
• 包含异步单元测试：使用 pytest 和 pytest - asyncio。

📦 安装指南

确保已安装 Python >= 3.10 和 Poetry，然后执行以下命令进行安装：

poetry install

📚 详细文档

配置

在运行服务器之前，必须设置环境变量 FHIR_BASE_URL，此 URL 用于构建模拟请求字符串。

export FHIR_BASE_URL="https://your-fhir-server-base.com/fhir"
# 或者用于本地测试：
# export FHIR_BASE_URL="http://localhost:8080/fhir"

使用

配置完成后，使用安装的脚本运行服务器：

fhir-mcp-server-medagentbench

服务器将开始监听标准输入/输出中的 MCP 请求。

开发

设置

克隆仓库并安装依赖项（包括开发工具）：

git clone https://github.com/MikeHolcomb/mcp-fhir-python-medagentbench.git
cd mcp-fhir-python-medagentbench
poetry install --with dev

格式检查和代码风格

该项目使用 pre-commit 执行代码样式（black, isort）和问题检查（flake8, mypy）。

# 在提交时运行所有检查（通常自动运行）
poetry run pre-commit run

# 运行所有文件的检查
poetry run pre-commit run --all-files

# 或者分别运行工具
poetry run black .
poetry run isort .
poetry run flake8 src tests
poetry run mypy src

测试

测试位于 tests/ 目录中，并使用 pytest。

poetry run pytest

# 带覆盖报告运行测试
poetry run pytest --cov=src

测试需要 pytest-asyncio 以支持异步功能。

贡献

我们欢迎社区的贡献！请参考项目仓库中的 CONTRIBUTING.md 文件了解如何参与。

📄 许可证

本项目采用 MIT 许可证。