mcp-kiwi-tcms

Kiwi TCMS 插件，在 Kiwi 进程内的 /mcp/ 上提供 Model Context Protocol 服务（Apache/WSGI、JSON Streamable HTTP，无 SSE）。

身份验证仅限 API 密钥：Authorization: Bearer kiwi_mcp_… 映射到 Django 用户。没有 HTTP Basic，没有 OAuth，没有 IdP。

在 Kiwi 镜像中安装

RUN pip install --no-cache-dir \
      "mcp-kiwi-tcms @ git+https://github.com/runitsolutions/mcp-kiwi-tcms@<sha>"

Kiwi 加载 kiwitcms.plugins 入口点 mcp = mcp_kiwi_tcms，因此 URL 会挂载到 /mcp/。然后：

./manage.py migrate mcp_kiwi_tcms
./manage.py kiwi_mcp_create_key --username <django-user> --name cursor

该命令会一次性打印明文 token。请将其存储在 git 之外。

从 Pod 中执行冒烟测试（请求必须到达 Django）：

curl -sS -X POST https://tms.seacrets.online/mcp/ \
  -H "Authorization: Bearer kiwi_mcp_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{}}}'

Related MCP server: tuskr-mcp-server

Cursor

{
  "mcpServers": {
    "kiwi-tcms": {
      "url": "https://tms.seacrets.online/mcp/",
      "headers": {
        "Authorization": "Bearer kiwi_mcp_…"
      }
    }
  }
}

在 Django 管理后台（MCP API keys）中撤销密钥，或设置 revoked_at。这不会更改用户的密码。

如果 Kiwi 前面的反向代理用 HTML 登录页拦截 /mcp，此插件将永远看不到该请求。该路由不在本文讨论范围内。

工具

读取：kiwi_ping, kiwi_list_products, kiwi_list_test_plans, kiwi_list_test_cases, kiwi_get_test_case, kiwi_list_test_runs, kiwi_get_test_run_summary, kiwi_list_executions, kiwi_list_builds, kiwi_list_versions, kiwi_list_priorities, kiwi_list_categories, kiwi_list_plan_types。

写入：kiwi_create_test_plan, kiwi_add_cases_to_plan, kiwi_create_test_case, kiwi_update_test_case, kiwi_create_test_run, kiwi_add_cases_to_run, kiwi_update_execution, kiwi_add_link_to_execution。

逃生通道：kiwi_rpc（Kiwi Class.method；*.remove / *.delete 已被阻止）。资源 kiwi://status。提示 summarize_test_run。

RPC 以拥有该密钥的 Django 用户身份运行。

开发

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest -q
ruff check .

许可证：AGPL-3.0-or-later，与 Kiwi TCMS 插件相同。