Kaiten

io.github.evvfebruary由 GitHub 账号 evvfebruary 发布v0.1.0更新于 Oct 24, 2026

Manage Kaiten spaces, boards, cards, comments, and tags with compact MCP responses.

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

Kaiten MCP 服务器，让 AI 助手浏览空间、看板和列，并创建、更新、移动、评论和打标签 Kaiten 卡片，返回精简结果。

可以做什么
  • 列出空间、看板、列和泳道，定位工作所在位置
  • 创建、读取、筛选和更新卡片，包括在看板、列和泳道之间移动
  • 添加和列出卡片评论
  • 列出标签、查看卡片标签，并添加或移除标签
  • 返回精简的分页结果，描述仅在需要时返回
适用场景
适合团队用 Kaiten 管理任务，并希望在 Cursor、Claude Code 或其他 MCP 客户端中通过对话查询看板与卡片，或直接做修改，而不必在网页界面和模型之间来回复制。
运行要求
通过 uvx 以 stdio 在本地运行，需要 Python 3.12+ 和 uv。需要 Kaiten API 令牌（KAITEN_API_TOKEN），并设置 KAITEN_WORKSPACE_SLUG 或用于本地部署/自定义域名的完整 KAITEN_BASE_URL。需要能访问你的 Kaiten 实例。README 还介绍了基于 Docker 或 Kubernetes 的 Streamable HTTP 模式。
安装前请注意
令牌拥有你 Kaiten 账号的权限，助手因此可以创建、更新、移动、评论真实卡片并增删标签。不要把令牌写进会提交的配置文件，优先使用环境变量。远程 HTTP 模式下每个客户端各自发送 Bearer 令牌，README 提醒不要记录 Authorization 头。需注意 Kaiten 的请求频率限制。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Kaiten，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

kaiten-mcp

MCP-сервер для Kaiten — интеграция канбан-досок и задач Kaiten с AI-ассистентами (Cursor, Claude Code и любым MCP-клиентом).

Управляйте карточками прямо из чата: создавайте задачи, перемещайте по колонкам, обновляйте описания, оставляйте комментарии и теги — без ручного копирования из веб-интерфейса и без огромных JSON-ответов API в контексте модели.

Зачем это нужно

  • Подключить Kaiten к Cursor / Claude Code через Model Context Protocol
  • Работать с пространствами, досками, колонками и карточками голосом агента
  • Экономить токены: ответы компактные по умолчанию (описания — только по запросу)
  • Развернуть локально (stdio) или для команды (Streamable HTTP / Docker / Kubernetes)

Возможности

  • Локальный транспорт stdio для Cursor и Claude Code
  • Удалённый Streamable HTTP (POST /mcp) для командного хостинга
  • Токен Kaiten на каждый запрос (credentials не сохраняются на диске)
  • Компактные списки: страница по умолчанию 20 (макс. 100), без вложений и «шумных» вложенных полей
  • Бенчмарки размера payload (kaiten-mcp-benchmark), чтобы ответы не раздувались со временем
  • Структурированные логи в stderr (безопасно для stdio MCP)

Быстрый старт

Требования

  • Python 3.12+
  • uv
  • API-токен Kaiten (Профиль → API-ключ в вашем инстансе, например https://<компания>.kaiten.ru/profile/api-key)

1. Установка и запуск

bash
export KAITEN_API_TOKEN='ваш-токен'export KAITEN_WORKSPACE_SLUG='ваша-компания'   # → https://ваша-компания.kaiten.ru/api/v1
uvx kaiten-mcp --transport stdio

uvx скачивает пакет из PyPI, создаёт изолированное окружение и запускает сервер. Клонировать репозиторий не требуется.

Для on-prem / кастомного домена вместо slug задайте полный корень API:

bash
export KAITEN_BASE_URL='https://kaiten.example.com/api/v1'

Остальные переменные — в .env.example.

2. Cursor

Конфиг проекта уже есть: .cursor/mcp.json.

  1. Экспортируйте токен и workspace в окружение, которое наследует Cursor:
bash
export KAITEN_API_TOKEN='ваш-токен'export KAITEN_WORKSPACE_SLUG='ваша-компания'
  1. Перезапустите Cursor после смены переменных окружения.
  2. Откройте Output → MCP Logs и убедитесь, что сервер kaiten подключился.
  3. Попросите агента: «покажи пространства» или «найди задачи на доске …».

${env:KAITEN_API_TOKEN} и ${env:KAITEN_WORKSPACE_SLUG} подставляет Cursor. Не коммитьте реальные токены.

3. Claude Code

Конфиг проекта: .mcp.json.

bash
export KAITEN_API_TOKEN='ваш-токен'export KAITEN_WORKSPACE_SLUG='ваша-компания'claude mcp list

Или вручную:

bash
claude mcp add --transport stdio kaiten -- uv run kaiten-mcp --transport stdio

Примеры запросов к агенту

  • «Покажи все пространства в Kaiten»
  • «Найди доски в пространстве X и создай карточку „Исправить баг логина“»
  • «Перенеси задачу #1234 в колонку In Progress»
  • «Добавь комментарий к карточке #1234: готово к ревью»
  • «Повесь тег „hotfix“ на задачу #1234»

Типовой порядок инструментов:

  1. list_spaces → list_boards → list_columns / list_lanes
  2. create_task / list_tasks / get_task / update_task / move_task
  3. add_comment / add_tag_to_task при необходимости

Инструменты MCP

ИнструментНазначение
list_spacesСписок пространств (id, title)
list_boardsДоски пространства
list_columnsКолонки доски
list_lanesДорожки доски
create_taskСоздать карточку (title + board_id)
get_taskДетали задачи (include_description — по запросу)
list_tasksФильтрованный компактный список (query, board, column, tag, …)
update_taskОбновление полей (title, description, owner, condition, …)
move_taskПеремещение (board / column / lane / sort)
add_comment / list_commentsКомментарии
list_tags / get_task_tagsТеги
add_tag_to_taskДобавить тег по имени
remove_tag_from_taskСнять тег по id

Удалённый сервер / Docker / Kubernetes

Streamable HTTP:

bash
uv run kaiten-mcp --transport streamable-http --host 0.0.0.0 --port 8000
  • Health: GET /healthz
  • MCP: POST /mcp

Docker:

bash
docker pull ghcr.io/evvfebruary/kaiten-mcp:latestdocker run --rm -p 8000:8000 \  -e KAITEN_WORKSPACE_SLUG=ваша-компания \  ghcr.io/evvfebruary/kaiten-mcp:latest

Для локальной разработки образ можно собрать командой docker build -t kaiten-mcp ..

Каждый клиент передаёт свой токен:

http
Authorization: Bearer <kaiten-api-token>

Примеры конфигов:

Заметки для Kubernetes:

  • Stateless-реплики допустимы (stateless_http=True)
  • TLS — на Ingress
  • Увеличьте proxy/read timeouts для streaming
  • Не логируйте заголовок Authorization
  • У Kaiten лимит порядка ~50 req/s — делите бюджет между репликами

Модель с Bearer-токеном на запрос — осознанный выбор v1 (не browser OAuth).

Переменные окружения

ПеременнаяОбязательнаОписание
KAITEN_API_TOKENДа (stdio)API-токен; для HTTP — также в Authorization: Bearer
KAITEN_WORKSPACE_SLUGДа*Slug: acme → https://acme.kaiten.ru/api/v1
KAITEN_BASE_URLДа*Полный корень API (on-prem); имеет приоритет над slug
KAITEN_HOST / KAITEN_PORTНетBind для HTTP (по умолчанию 127.0.0.1:8000)
KAITEN_LOG_LEVELНетDEBUG | INFO | WARNING | ERROR
KAITEN_LOG_FORMATНетtext | json
KAITEN_LOG_BODIESНетКомпактные redacted-превью в логах
KAITEN_ENABLE_METRICSНетМетрики размера payload без секретов

* Нужен либо KAITEN_WORKSPACE_SLUG, либо KAITEN_BASE_URL.

Экономия токенов

  • Размер страницы списка по умолчанию: 20 (макс. 100)
  • В списках нет описаний, вложений и глубоких дублей
  • Мутации возвращают id/url и изменённые поля
  • Обрезка явная: truncated, next_offset, has_more
  • Коротко описанные схемы инструментов

Проверка бюджетов размера ответа:

bash
uv run kaiten-mcp-benchmarkuv run kaiten-mcp-benchmark --check

Логирование

Логи всегда идут в stderr (совместимо со stdio MCP).

bash
export KAITEN_LOG_LEVEL=INFOexport KAITEN_LOG_FORMAT=jsonuv run kaiten-mcp --transport stdio --log-format json

Полезные события: server_starting, tool_start / tool_success / tool_error, kaiten_request, kaiten_rate_limited.

Секреты редактируются; токены видны только как fingerprint вида token_fp=len=40:…ab12.

Разработка

bash
uv sync --all-groupsuv run ruff format .uv run ruff check .uv run ty checkuv run pytestuv run kaiten-mcp-benchmark --check

Live smoke (опционально, не в CI по умолчанию):

bash
KAITEN_API_TOKEN=... KAITEN_WORKSPACE_SLUG=... uv run pytest -m live

Публикация релизов (PyPI, GHCR, Official MCP Registry) описана в RELEASING.md.

Структура

text
src/kaiten_mcp/  api/           # HTTP-клиент и адаптеры эндпоинтов  tools/         # MCP-инструменты  auth.py        # Токен на запрос  config.py      # Настройки  presentation.py  metrics.py  server.py  __main__.pytests/benchmarks/examples/remote-mcp/server.json      # Official MCP Registry metadataRELEASING.md

Безопасность

  • Токен берётся из HTTP Bearer или KAITEN_API_TOKEN на каждый запрос
  • Сервер не пишет токены на диск
  • Предпочитайте переменные окружения, а не хардкод в MCP JSON
  • Права на стороне Kaiten определяются токеном вызывающего

FAQ

Как подключить Kaiten к Cursor?
Установите зависимости через uv, задайте KAITEN_API_TOKEN и KAITEN_WORKSPACE_SLUG, перезапустите Cursor — конфиг уже в .cursor/mcp.json.

Где взять API-токен Kaiten?
В вашем инстансе: Профиль → API-ключ (https://<компания>.kaiten.ru/profile/api-key). OAuth у публичного API Kaiten для этого сценария не используется.

Чем этот сервер отличается от других kaiten-mcp?
Фокус на компактных ответах и экономии контекста модели, плюс готовый remote Streamable HTTP для команды без хранения токенов на сервере.

Можно ли развернуть для всей команды?
Да: Docker / Kubernetes с streamable-http; каждый сотрудник передаёт свой Bearer-токен в заголовке.

Работает ли с on-prem Kaiten?
Да — задайте KAITEN_BASE_URL на ваш /api/v1.

Лицензия

MIT

来源：README.md，提交 428aa1f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分