mcp-kiwi-tcms

Kiwi プロセス内の /mcp/ で Model Context Protocol を提供する Kiwi TCMS プラグインです(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

コマンドは平文トークンを 一度だけ 出力します。git の外部に保存してください。

ポッドからスモークテストします(リクエストが 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 の前段のリバースプロキシが /mcp を HTML ログインページでインターセプトする場合、このプラグインはリクエストを一切受け取りません。そのルーティングはここでは対象外です。

ツール

読み取り: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 プラグインと同じです。