Backlog MCP Server

servidor de registro de retrasos mcp

Servidor MCP atrasado

Este es un servidor basado en TypeScript que integra Backlog con el Protocolo de contexto de modelo (MCP). Implementa los siguientes conceptos clave de MCP:

• Un recurso que representa un proyecto Backlog (incluido URI y metadatos)
• Herramientas para interactuar con la API Backlog
• Indicaciones para generar resúmenes y análisis de los datos del Backlog

función

recurso

• Acceda a un proyecto Backlog a través backlog://project/[id]
• Cada recurso del proyecto contiene metadatos y detalles del proyecto.
• Recursos con formato JSON para el acceso a datos estructurados
• Acceder a problemas dentro de un proyecto
• Cómo acceder a una página Wiki en un proyecto

herramienta

• get_backlog_user - Obtener información actual del usuario del Backlog
• get_backlog_space - Obtener información del espacio del Backlog
• list_recent_projects - Lista los proyectos pendientes vistos recientemente
  • Se puede configurar el número y el orden de clasificación
• get_project_issues - Obtener los problemas de un proyecto
  • Filtrar por estado, cesionario, paginación, etc.
• get_issue_detail - Obtenga información detallada sobre un problema específico
• get_issue_comments - Obtener los comentarios de un problema
• add_issue_comment - Agregar un comentario a un problema
• get_issue_comment_count - Obtener el número de comentarios sobre un problema
• get_issue_comment - Obtener información detallada sobre un comentario específico
• get_wiki_page_list - Obtener una lista de páginas Wiki
  • Filtrar por proyecto o palabra clave
• get_wiki_page - Obtener información detallada sobre una página wiki específica
• update_wiki_page - Actualizar una página wiki

inmediato

• summarize_projects - Genera resúmenes de proyectos Backlog vistos recientemente
• analyze_backlog_usage : analiza los patrones de uso del Backlog según los datos de usuario, espacio y proyecto.
• summarize_wiki_pages - Genera resúmenes de las páginas wiki de un proyecto

Prerrequisitos

• Una cuenta Backlog con acceso a la API
• variables ambientales:
  • BACKLOG_API_KEY : Clave de API de backlog
  • BACKLOG_SPACE_URL : URL del espacio de backlog (p. ej., https://your-space.backlog.com )

desarrollo

Instalar dependencias:

Construir el servidor:

Desarrollo con reconstrucción automática:

instalar

Para usarlo con Claude Desktop, agregue la configuración de su servidor:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

depurar

Los servidores MCP se comunican a través de entrada y salida estándar, por lo que puede ser difícil depurarlos. Recomendamos utilizar MCP Inspector . Este paquete está disponible como script:

Inspector proporciona una URL para acceder a las herramientas de depuración en su navegador.

Detalles técnicos

El servidor consta de los siguientes componentes principales:

• index.ts : punto de entrada principal, inicializa y configura el servidor MCP
• backlog-client.ts : un cliente que maneja la comunicación con la API Backlog.
• handlers/ - manejadores de recursos, herramientas y solicitudes
  • resource-handlers.ts : controladores de recursos para proyectos, problemas y wikis
  • tool-handlers.ts : herramientas para interactuar con la API Backlog
  • prompt-handlers.ts - Funciones de generación de mensajes
• types.ts - Definiciones de tipos para las respuestas de la API Backlog
• config.ts - Carga de la configuración desde las variables de entorno