medical-calc-mcp: Instructions file for GitHub Copilot

Copilot Instructions for Medical Calculator MCP

Medical Calculator MCP Server - 醫學計算工具 MCP 伺服器 為 AI Agent 提供經過驗證的醫學計算工具

📊 專案概況

指標	數值
計算器數量	151 (涵蓋 31 個專科)
Unified MCP Tools	6 (3 發現工具 + 3 計算工具)
測試數量	2073+
測試覆蓋率	92%
文獻引用	244 PMIDs, 205 DOIs (100% 覆蓋)
架構	DDD Onion + FastMCP
Python 版本	3.11+
套件管理	uv

🛠️ 開發環境

# 安裝依賴
uv sync

# 執行測試
uv run pytest

# 執行型別檢查 (必須通過 --strict)
uv run mypy --no-incremental --strict src tests

# 執行 Lint 檢查
uv run ruff check .

# 計算工具數量
uv run python scripts/count_tools.py

# 計算引用文獻數量
uv run python scripts/count_references.py

# 啟動 MCP 伺服器 (stdio)
uv run python -m src.main

# 啟動 MCP 開發模式
uv run mcp dev src/main.py

# 啟動 REST API
uv run python src/main.py --mode api --port 8080

📁 專案結構

src/
├── domain/           # 核心業務邏輯 (無依賴)
│   ├── entities/     # ScoreResult, ToolMetadata
│   ├── services/     # BaseCalculator, ToolRegistry
│   │   └── calculators/  # 151 個計算器實作
│   ├── validation/   # ParameterValidator, BoundarySpec
│   └── value_objects/    # Unit, Reference, Interpretation
├── application/      # 用例層
│   └── use_cases/    # DiscoveryUseCase, CalculateUseCase
├── infrastructure/   # 基礎設施層
│   ├── mcp/          # MCP Server, Handlers
│   │   └── handlers/ # 按專科分類的 handlers
│   └── api/          # REST API (FastAPI)
└── shared/           # 共用工具

🔧 新增計算器標準流程

1. 建立 Calculator (Domain Layer)

位置: src/domain/services/calculators/[specialty]/

from ..base import BaseCalculator
from ...entities.score_result import ScoreResult
from ...entities.tool_metadata import ToolMetadata
from ...value_objects.reference import Reference
from ...value_objects.tool_keys import LowLevelKey, HighLevelKey, Specialty

class MyCalculator(BaseCalculator):
    @property
    def tool_id(self) -> str:
        return "my_calculator"

    @property
    def metadata(self) -> ToolMetadata:
        return ToolMetadata(...)

    @property
    def references(self) -> list[Reference]:
        return [Reference(citation="...", doi="...", pmid="...", year=2020)]

    def calculate(self, param1: float, param2: str) -> ScoreResult:
        # 實作計算邏輯
        pass