Servidor MCP de FogBugz

Un servidor del Protocolo de Contexto de Modelo (MCP) para interactuar con FogBugz a través de LLMs como Claude. Admite tanto la API XML (/api.asp) como la API JSON (/f/api/0/jsonapi) con detección automática de versión al inicio. Funciona con instalaciones de FogBugz locales y bajo demanda.

Descripción general

Permite a los LLMs realizar operaciones en FogBugz:

• Crear, actualizar, resolver, reabrir y cerrar casos

• Asignar casos a usuarios específicos

• Buscar y listar casos con historial completo de eventos/comentarios

• Listar usuarios, categorías, proyectos y áreas

• Crear nuevos proyectos

• Solicitudes de API genéricas para casos de uso avanzados

Detección automática de API

Al iniciarse, el servidor selecciona automáticamente el cliente de API correcto para su instancia de FogBugz:

1. Sondea /api.xml para leer el número de versión de FogBugz.

2. Si la versión es ≥ 9, intenta acceder a la API JSON (/f/api/0/jsonapi) — utiliza FogBugzJsonClient si tiene éxito.

3. Vuelve a FogBugzXmlClient (API XML a través de /api.asp) para versiones < 9 o si el punto final JSON no es accesible.

No se necesita configuración: el cliente correcto se selecciona automáticamente.

Nota sobre el formato de texto: Solo se admite texto sin formato en descripciones y comentarios cuando se conecta a FogBugz 8.x a través de la API XML. HTML y Markdown se almacenan y muestran literalmente.

Obtención de un token de API de FogBugz

Necesita un token de API para autenticar el servidor MCP con FogBugz. Hay dos formas de obtener uno:

1. A través de la interfaz web

Vaya a Account & Settings → User Options y haga clic en el enlace Create API Token.

Consulte la guía oficial: Create API Token using the FogBugz UI

2. A través de una solicitud de API

Envíe la siguiente solicitud (reemplace los marcadores de posición con sus valores):

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

La respuesta contendrá su token de API.

Consulte la guía oficial: Get an API Token using FogBugz API commands

Instalación

Instalación con un clic (Claude Desktop)

Descargue el paquete .mcpb más reciente de la página de Lanzamientos y ábralo; Claude Desktop instalará y configurará el servidor automáticamente, solicitándole su URL de FogBugz y su clave de API.

Instalación manual

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

Configuración del cliente MCP

Añada a la configuración de su cliente MCP (por ejemplo, claude_desktop_config.json de 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"
      }
    }
  }
}

Alternativamente, pase las credenciales como argumentos de línea de comandos:

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

Ejecución manual

# 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

Desarrollo

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

Herramientas MCP

Gestión de casos

Búsqueda y visualización

Datos de referencia

Avanzado

Variables de entorno

Compatibilidad

Probado con FogBugz 8.8.53 (API XML). La compatibilidad con la API JSON se implementa según la especificación. El servidor detecta automáticamente qué API usar al inicio.

Agradecimientos

Este proyecto se basa en el trabajo original de Sarasvati Akari Lara-Almeida — gracias por la base.

Licencia

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