MCP-сервер FogBugz

Сервер Model Context Protocol (MCP) для взаимодействия с FogBugz через LLM, такие как Claude. Поддерживает как XML API (/api.asp), так и JSON API (/f/api/0/jsonapi) с автоматическим определением версии при запуске. Работает с локальными и облачными инсталляциями FogBugz.

Обзор

Позволяет LLM выполнять операции в FogBugz:

• Создание, обновление, решение, повторное открытие и закрытие задач

• Назначение задач конкретным пользователям

• Поиск и просмотр списка задач с полной историей событий/комментариев

• Получение списка пользователей, категорий, проектов и областей

• Создание новых проектов

• Выполнение произвольных API-запросов для продвинутых сценариев

Автоматическое определение API

При запуске сервер автоматически выбирает подходящий API-клиент для вашего экземпляра FogBugz:

1. Опрашивает /api.xml для чтения номера версии FogBugz.

2. Если версия ≥ 9, пытается обратиться к JSON API (/f/api/0/jsonapi) — в случае успеха использует FogBugzJsonClient.

3. Если версия < 9 или JSON-эндпоинт недоступен, переключается на FogBugzXmlClient (XML API через /api.asp).

Настройка не требуется — правильный клиент выбирается автоматически.

Примечание о форматировании текста: При подключении к FogBugz 8.x через XML API в описаниях и комментариях поддерживается только обычный текст. HTML и Markdown сохраняются и отображаются буквально.

Получение API-токена FogBugz

Для аутентификации MCP-сервера в FogBugz вам потребуется API-токен. Есть два способа его получить:

1. Через веб-интерфейс

Перейдите в Account & Settings → User Options и нажмите на ссылку Create API Token.

См. официальное руководство: Create API Token using the FogBugz UI

2. Через API-запрос

Отправьте следующий запрос (замените плейсхолдеры на свои значения):

https://[your-fogbugz-server]/api.asp?cmd=logon&email=[your-email]&password=[your-password]

Ответ будет содержать ваш API-токен.

См. официальное руководство: Get an API Token using FogBugz API commands

Установка

Установка в один клик (Claude Desktop)

Скачайте последний пакет .mcpb со страницы Releases и откройте его — Claude Desktop автоматически установит и настроит сервер, запросив у вас URL FogBugz и API-ключ.

Ручная установка

git clone https://github.com/todevelopers/fogbugz-mcp.git
cd fogbugz-mcp
npm install
npm run build

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

Добавьте в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json для Claude Desktop):

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": ["/absolute/path/to/fogbugz-mcp/dist/index.js"],
      "env": {
        "FOGBUGZ_URL": "https://your-fogbugz-server.com",
        "FOGBUGZ_API_KEY": "your-api-token"
      }
    }
  }
}

Альтернативно, передайте учетные данные в качестве аргументов командной строки:

{
  "mcpServers": {
    "fogbugz": {
      "command": "node",
      "args": [
        "/absolute/path/to/fogbugz-mcp/dist/index.js",
        "https://your-fogbugz-server.com",
        "your-api-token"
      ]
    }
  }
}

Ручной запуск

# With command-line arguments
node dist/index.js https://your-fogbugz-server.com your-api-token

# With environment variables
FOGBUGZ_URL=https://your-fogbugz-server.com FOGBUGZ_API_KEY=your-api-token npm start

# With a .env file
cp .env.example .env   # fill in FOGBUGZ_URL and FOGBUGZ_API_KEY
npm start

Разработка

npm run dev    # run via ts-node (no build needed)
npm run build  # compile TypeScript to dist/
npm test       # run all Jest tests

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

Управление задачами

Поиск и просмотр

Справочные данные

Продвинутые возможности

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

Совместимость

Протестировано с FogBugz 8.8.53 (XML API). Поддержка JSON API реализована согласно спецификации. Сервер автоматически определяет, какой API использовать при запуске.

Благодарности

Этот проект основан на оригинальной работе Sarasvati Akari Lara-Almeida — спасибо за фундамент.

Лицензия

MIT © Tomáš Gažovič, ToDevelopers s.r.o.