MCP Server(Claude)

APITestka 內建 Model Context Protocol server,Claude Code(以及其他 MCP-compatible client)能直接把這個框架當成 tool 使用。實作站在 optional mcp Python SDK 上;tool 派發跟網路層解耦,所以單元測試可以直接呼叫。

安裝

pip install 'je_api_testka[mcp]'

啟動方式

三種等價寫法:

apitestka-mcp
apitestka mcp
python -m je_api_testka.mcp_server

伺服器走標準 MCP stdio transport,直到 client 斷線為止。

曝露的 tool

Tool	用途
`apitestka_run_action`	執行 executor action list
`apitestka_test_api`	一次性 HTTP 請求(走 `requests` 後端)
`apitestka_curl_to_action`	cURL → action JSON
`apitestka_har_import`	HAR 檔 → action list
`apitestka_render_markdown`	從目前測試紀錄產 Markdown 報告
`apitestka_records_to_openapi`	反推 OpenAPI 3.x 文件
`apitestka_clear_records`	清空測試紀錄
`apitestka_get_records`	拿目前的成功 / 失敗紀錄

Claude Code 設定

加進 ~/.claude/mcp.json:

{
  "mcpServers": {
    "apitestka": {
      "command": "apitestka-mcp"
    }
  }
}

直接呼叫 dispatch

from je_api_testka.mcp_server import dispatch_tool

dispatch_tool("apitestka_run_action", {"actions": [["AT_fake_uuid"]]})
dispatch_tool("apitestka_render_markdown", {})