Fhir MCP Server Medagentbench

🚀 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 許可證。