testlink-mcp

AI-ориентированный, безопасный по своей сути сервер Model Context Protocol для TestLink 1.9.20. Он предоставляет нормализованные инструменты обнаружения и анализа, ограниченную курсорную пагинацию, структурированный вывод и запись с предварительным просмотром перед применением через stdio.

Этот репозиторий представляет собой чистую реализацию, основанную на публичном XML-RPC интерфейсе TestLink и публичном MCP SDK. Он не зависит от частного пакета TestLink или частного дерева исходников.

Возможности

• Запускается без учетных данных, чтобы MCP-клиенты могли обнаруживать все инструменты, ресурсы и подсказки.

• Явный детерминированный демонстрационный режим для оценки и адаптации.

• structuredContent, outputSchema, аннотации инструментов, курсорная пагинация и стабильные коды ошибок.

• Только метаданные вложений; содержимое вложений и base64-нагрузки удалены.

• Запись отключена по умолчанию. Инструмента удаления нет.

• Каждое применение требует confirm: true, непросроченного 10-минутного предварительного просмотра и неизмененного снимка сервера.

• Вызовы с побочными эффектами никогда не повторяются автоматически; попытки применения записываются в редактируемый журнал операций.

• Защита времени выполнения блокирует неподдерживаемые/вышедшие из эксплуатации нечетные версии Node и уровни исправлений безопасности ниже заявленного минимума.

Related MCP server: TestRail MCP Server

Требования

• Node.js ^22.23.2 || ^24.18.1 || ^26.5.1

• TestLink 1.9.20 с включенным XML-RPC API

Базовая версия для разработки и контейнеров — Node 24.19.0 LTS. CI также запускает Node 22.23.2 и 26.7.0.

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

nvm use
npm ci
npm run build
TESTLINK_DEMO_MODE=true node dist/cli.js

Будущий вызов npm после публикации:

npx -y testlink-mcp@1.0.0

Конфигурация MCP-клиента:

{
  "mcpServers": {
    "testlink": {
      "command": "npx",
      "args": ["-y", "testlink-mcp@1.0.0"],
      "env": {
        "TESTLINK_URL": "https://testlink.example.com/testlink",
        "TESTLINK_DEV_KEY": "your-testlink-dev-key"
      }
    }
  }
}

Не помещайте реальные учетные данные в отслеживаемые файлы. Скопируйте .env.example в игнорируемый .env или внедрите переменные окружения из вашего MCP-клиента/менеджера секретов.

Инструменты

Все инструменты возвращают:

{
  "ok": true,
  "data": {},
  "meta": {
    "source": "testlink",
    "requestId": "..."
  }
}

Сбои используют ok: false с { code, message, retryable, details? }. Потребители должны ветвиться по error.code, а не по тексту сообщения.

Безопасный рабочий процесс записи

1. Найдите существующий тест-кейс и получите его текущую версию.

2. Проверьте желаемый тест-кейс.

3. Вызовите соответствующий инструмент предпросмотра.

4. Покажите proposedChanges пользователю и получите явное подтверждение.

5. Вызовите apply с идентификатором предпросмотра и confirm: true в течение 10 минут.

6. Если apply возвращает CONFLICT или PREVIEW_EXPIRED, создайте и просмотрите новый предпросмотр.

Включайте запись только в том серверном процессе, который должен их выполнять:

TESTLINK_WRITE_ENABLED=true npx -y testlink-mcp@1.0.0

Путь к журналу по умолчанию: ~/.local/state/testlink-mcp/operations.jsonl. Переопределите его с помощью TESTLINK_LEDGER_PATH. Журнал содержит хэши и редактируемые результаты, а не ключи разработчика.

Конфигурация

Демонстрационный режим явный и имеет приоритет над удаленной конфигурацией:

TESTLINK_DEMO_MODE=true TESTLINK_WRITE_ENABLED=true node dist/cli.js

Разработка

npm ci
npm run check
npm test
npm run eval
npm run build
npm audit --omit=dev --audit-level=high
npm pack --dry-run

Офлайн-оценка выбора инструментов проверяет, что типичные намерения пользователя выбирают инструменты поиска, проверки, предпросмотра и применения отдельно. Она детерминирована и не отправляет данные внешней модели.

Docker

Образ запускается от имени непривилегированного пользователя и использует Node 24.19.0. Сборка без публикации:

docker buildx build --platform linux/amd64,linux/arm64 --tag testlink-mcp:local --output type=oci,dest=testlink-mcp.oci.tar .

Будущее имя образа после одобрения и публикации: ghcr.io/easonlin/testlink-mcp:1.0.0.

Политика выпуска

Версия 1.0.0 готова к выпуску, но публикация остается явным действием. Защищенный рабочий процесс выпуска требует подписанного тега версии, повторно запускает все этапы тестирования/оценки/аудита/SBOM/пакета, публикует npm с подтверждением происхождения, публикует многоплатформенный образ GHCR с SBOM и подтверждением происхождения, создает релиз GitHub и, наконец, публикует проверенную запись в реестре MCP.

Отдельный защищенный рабочий процесс live-smoke проверяет установленный пакет на реальном экземпляре TestLink 1.9.20 с использованием вызовов только для чтения. Его URL и ключ разработчика должны храниться как секреты окружения и никогда не записываются в журналы.

Манифест пакета и server.json используют общее имя MCP io.github.easonlin/testlink-mcp. Проверку реестра можно запустить без публикации:

mcp-publisher validate server.json

Публичные ссылки

• Исходный код и ветка выпуска TestLink 1.9.20

• TypeScript SDK Model Context Protocol

• Официальные команды издателя реестра MCP

Лицензия

MIT