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

이 명령은 평문 토큰을 한 번만 출력합니다. 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: kiwi-tcms-mcp

Cursor

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

Django admin에서 키를 폐기하거나(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 플러그인과 동일합니다.