Servidor MCP de FogBugz

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con FogBugz a través de modelos de aprendizaje de idiomas (LLM) como Claude.

Descripción general

Este servidor permite a los LLM realizar varias operaciones en FogBugz, entre ellas:

Creación de nuevos problemas/casos con archivos adjuntos opcionales
Actualización de casos existentes (cambio de proyecto, área, hito, prioridad)
Asignar casos a usuarios específicos
Listado de casos abiertos de un usuario
Obtener enlaces directos a casos específicos
Búsqueda de casos por diversos criterios

El servidor implementa la especificación del Protocolo de contexto de modelo (MCP) , lo que permite que cualquier cliente LLM compatible con MCP lo utilice.

Antecedentes del proyecto

Este proyecto se inició con la ayuda del modelo o3-mini-high de OpenAI , que generó un plan de desarrollo integral (véase DEVELOPMENT-PLAN.md en el repositorio). El plan describió la arquitectura, las herramientas y los detalles de implementación para construir un servidor MCP de FogBugz en TypeScript.

La especificación detallada sirvió de modelo para el equipo de desarrollo, demostrando cómo la IA puede asistir eficazmente en las primeras fases del diseño y la planificación de proyectos. Este proyecto es tanto un ejemplo de desarrollo asistido por IA como una herramienta que mejora las capacidades de la IA mediante el protocolo MCP.

Instalación

# Install from npm
npm install -g fogbugz-mcp

# Or use directly with npx
npx fogbugz-mcp <fogbugz-url> <api-key>

Uso

Uso básico

# Run with command line arguments
fogbugz-mcp https://yourcompany.fogbugz.com your-api-key

# Or use environment variables
export FOGBUGZ_URL=https://yourcompany.fogbugz.com
export TEST_FOGBUGZ_API_KEY=your-api-key
fogbugz-mcp

Desarrollo

# Clone the repository
git clone https://github.com/yourusername/fogbugz-mcp.git
cd fogbugz-mcp

# Install dependencies
npm install

# Create a .env file with your FogBugz credentials
echo "FOGBUGZ_URL=https://yourcompany.fogbugz.com" > .env
echo "TEST_FOGBUGZ_API_KEY=your-api-key" >> .env

# Run API explorer to test FogBugz API
npm run explore

# Run the development version of the server
npm run dev

# Run tests
npm test

# Build the project
npm run build

Explorador de API

El proyecto incluye una herramienta de exploración de API para probar los puntos finales de la API de FogBugz directamente:

# Run all API tests
npm run explore

# Run a specific test (by index)
npm run explore 0  # Run the first test

Herramientas MCP

Este servidor proporciona las siguientes herramientas MCP para LLM:

fogbugz_create_case - Crea un nuevo caso de FogBugz
fogbugz_update_case - Actualizar los campos de un caso existente
fogbugz_assign_case - Asignar un caso a un usuario específico
fogbugz_list_my_cases - Lista de casos asignados a un usuario específico
fogbugz_search_cases - Busca casos usando una cadena de consulta
fogbugz_get_case_link - Obtener un enlace directo a un caso específico

Licencia

ISC