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

Related MCP server: Linear MCP Server

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:

npm install

Construir el servidor:

npm run build

Desarrollo con reconstrucción automática:

npm run watch

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

{ "mcpServers": { "mcp-backlog-server": { "command": "/path/to/mcp-backlog-server/build/index.js", "env": { "BACKLOG_API_KEY": "your-api-key", "BACKLOG_SPACE_URL": "https://your-space.backlog.com" } } } }

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:

npm run inspector

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