kiwi-tcms-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kiwi-tcms-mcpshow me the latest test runs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
kiwi-tcms-mcp
MCP-сервер (Model Context Protocol) для полного доступа к API Kiwi TCMS на Node.js + TypeScript.
Работает поверх официального JSON-RPC endpoint'а Kiwi TCMS (/json-rpc/) с аутентификацией логин/пароль (Auth.login, как в tcms-api). Подключается к любому MCP-клиенту (Claude Desktop, VS Code, Cline, Cursor, MCP Inspector) по stdio.
Возможности
68 инструментов: планы, кейсы, раны, исполнения, справочники (версии, теги, статусы, пользователи), вложения, properties + сквозной
kiwi_rpc.Именованные аргументы: приоритеты, категории, статусы, сборки, типы планов и пользователи принимаются по имени — сервер сам резолвит их в id.
Проект по умолчанию:
KIWI_PROJECT(Product в терминах Kiwi) автоматически подставляется в фильтры и создание объектов.Ресурс
kiwi://statusи промптrun-summary(сводка по тест-рану).Понятные ошибки: HTTP-коды, JSON-RPC-ошибки, таймауты (
KIWI_TIMEOUT), подсказки что проверить.Безопасность: пароль не логируется, весь диагностический вывод — только в stderr.
Related MCP server: Jira QMetry MCP Server
Установка
npm install -g @kiwi-tcms-ai/kiwi-tcms-mcp
kiwi-tcms-mcp --helpИли без глобальной установки: npx -y @kiwi-tcms-ai/kiwi-tcms-mcp --help.
Клиент API — @kiwi-tcms-ai/kiwi-tcms-client (ставится автоматически).
Локальная сборка из исходников:
cd kiwi-tcms-mcp
npm install
npm run build # tsc -> dist/
node dist/index.js --helpТребования: Node.js ≥ 18 (используется глобальный fetch).
Конфигурация
Параметры задаются переменными окружения или CLI-флагами (флаги приоритетнее).
Env | Флаг | Обязат. | Описание |
|
| да | Базовый URL инстанса, например |
|
| да | Логин Kiwi TCMS ( |
|
| да | Пароль Kiwi TCMS |
|
| нет | Проект/Product по умолчанию (имя или id) |
|
| нет | Таймаут JSON-RPC запроса, мс (по умолчанию 30000) |
|
| нет | Лимит строк в list/filter-инструментах (по умолчанию 20) |
|
| нет | Не проверять TLS-сертификат (только self-signed в закрытом контуре) |
Пример прямого запуска:
npx -y @kiwi-tcms-ai/kiwi-tcms-mcp \
--url https://tcms.example.com \
--username api-bot \
--password keep-me-secret \
--project "Payments"Подключение к MCP-клиентам
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"kiwi-tcms": {
"command": "npx",
"args": ["-y", "@kiwi-tcms-ai/kiwi-tcms-mcp"],
"env": {
"KIWI_URL": "https://tcms.example.com",
"KIWI_USERNAME": "api-bot",
"KIWI_PASSWORD": "keep-me-secret",
"KIWI_PROJECT": "Payments"
}
}
}
}После npm install -g @kiwi-tcms-ai/kiwi-tcms-mcp можно писать "command": "kiwi-tcms-mcp" без args.
VS Code (.vscode/mcp.json):
{
"servers": {
"kiwi-tcms": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@kiwi-tcms-ai/kiwi-tcms-mcp"],
"env": {
"KIWI_URL": "https://tcms.example.com",
"KIWI_USERNAME": "api-bot",
"KIWI_PASSWORD": "keep-me-secret",
"KIWI_PROJECT": "Payments"
}
}
}
}Cline / Cursor (mcp_settings.json) — как Claude Desktop (mcpServers).
Отладка через MCP Inspector:
KIWI_URL=https://tcms.example.com KIWI_USERNAME=api-bot KIWI_PASSWORD=... KIWI_PROJECT=Payments \
npx @modelcontextprotocol/inspector npx -y @kiwi-tcms-ai/kiwi-tcms-mcpИнструменты
Инструмент | Метод Kiwi TCMS | Назначение |
|
| Проверка соединения и логина |
|
| Список проектов |
|
| Сборки продукта |
|
| Компоненты продукта |
|
| Приоритеты |
|
| Категории кейсов |
|
| Поиск тест-планов |
|
| Создание плана |
|
| Привязка кейса к плану |
|
| Гибкий поиск кейсов |
|
| Карточка кейса; |
|
| Создание кейса; тело кейса — в |
|
| Обновление полей; |
|
| Комментарий к кейсу |
|
| История изменений кейса |
|
| Поиск тест-ранов |
|
| Создание рана |
|
| Добавление кейсов в ран |
|
| Сводка по рану, упавшие кейсы |
|
| Поиск исполнений |
|
| Смена статуса/сборки/исполнителя |
|
| Создать продукт |
|
| Создать сборку (через Version) |
|
| Версии продукта |
|
| Типы планов |
|
| Статусы кейсов |
|
| Статусы исполнений |
|
| Пользователи / текущий логин |
|
| Теги |
|
| Классификации продуктов |
|
| Обновить план |
|
| Убрать кейс из плана |
|
| Дерево плана |
|
| Теги плана |
|
| Обновить/закрыть ран |
|
| Кейсы рана + execution_id |
|
| Теги кейса |
|
| Компоненты кейса |
|
| Ссылки/баги на исполнение |
|
| Вложения кейса/плана/рана/исполнения |
|
| Удалить вложение |
|
| Properties кейса/рана/исполнения |
| любой | Сквозной вызов оставшихся методов |
Плюс ресурс kiwi://status (конфиг + live-проверка) и промпт run-summary.
Структура
kiwi-tcms-mcp/
├── package.json # зависит от @kiwi-tcms-ai/kiwi-tcms-client из npm
├── tsconfig.json
└── src/
├── index.ts # входная точка: stdio-транспорт, сборка сервера
├── config.ts # env + CLI-флаги, валидация
└── tools.ts # MCP-схемы; логика — в kiwi-tcms-clientЛицензия
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceAn MCP server providing 63 tools to interact with Redmine instances, covering issues, projects, time entries, and wiki pages. It utilizes streamable HTTP transport and supports per-client authentication for secure management of Redmine resources.18
- AlicenseBqualityCmaintenanceMCP server to interact with the QMetry for Jira API, enabling management of test cases, test cycles, test plans, and more through well-defined tools.9311Apache 2.0
- FlicenseBqualityDmaintenanceMCP server to interact with the Shortcut project management API, providing 73 tools for managing stories, epics, iterations, milestones, projects, and more.73
- Alicense-qualityCmaintenanceMCP server for TestRail API, providing AI assistants with 107 tools to manage test cases, runs, results, plans, and more. Supports API key, password, and SSO cookie authentication.142MIT
Related MCP Connectors
MCP server for AI access to SmartBear tools, including BugSnag, Reflect, Swagger, PactFlow, QTM4J.
Go MCP server for GitLab: 2 dynamic tools reach 1000+ REST/GraphQL actions. Free/CE, no paid tier.
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/belovdm/kiwi-tcms-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server