Servidor MCP atrasado

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la API de Backlog. Este servidor proporciona herramientas para gestionar proyectos, incidencias, páginas wiki y más en Backlog mediante agentes de IA como Claude Desktop, Cline, Cursor, etc.

Características

Gestión de proyectos (crear, leer, actualizar, eliminar)
Seguimiento de problemas (crear, actualizar, eliminar, listar)
Gestión de páginas wiki
Gestión del repositorio Git
Gestión de solicitudes de extracción (crear, actualizar, listar, comentar)
Gestión de notificaciones
Gestión de listas de vigilancia
Y más integraciones de API Backlog

Requisitos

Estibador
Una cuenta Backlog con acceso a la API
Clave API de su cuenta Backlog

Instalación

Opción 1: Instalar mediante Docker

La forma más sencilla de utilizar este servidor MCP es a través de la configuración de MCP para Claude Desktop o Cline:

Abra Claude Desktop o la configuración de Cline
Navegue a la sección de configuración de MCP
Agregue la siguiente configuración:

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

Reemplace your-domain.backlog.com con su dominio de Backlog y your-api-key con su clave API de Backlog.

Opción 2: Instalación manual

Clonar el repositorio:
git clone https://github.com/nulab/backlog-mcp-server.git cd backlog-mcp-server
Instalar dependencias:
npm install
Construir el proyecto:
npm run build
Configura tu json para usarlo como MCP

{
  "mcpServers": {
    "backlog": {
      "command": "node",
      "args": [
        "your-repojitory-location/build/index.js"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

Herramientas disponibles

El servidor proporciona las siguientes herramientas para interactuar con Backlog:

Herramientas espaciales

Nombre de la herramienta	Descripción
`get_space`	Devuelve información sobre el espacio Backlog
`get_users`	Devuelve la lista de usuarios en el espacio Backlog
`get_myself`	Devuelve información sobre el usuario autenticado
`get_priorities`	Devuelve la lista de prioridades
`get_resolutions`	Devuelve una lista de resoluciones de problemas
`get_issue_types`	Devuelve una lista de tipos de problemas para un proyecto

Herramientas del proyecto

Nombre de la herramienta	Descripción
`get_project_list`	Devuelve la lista de proyectos
`add_project`	Crea un nuevo proyecto
`get_project`	Devuelve información sobre un proyecto específico
`update_project`	Actualiza un proyecto existente
`delete_project`	Elimina un proyecto

Herramientas de problemas

Nombre de la herramienta	Descripción
`get_issue`	Devuelve información sobre un problema específico
`get_issues`	Devuelve la lista de problemas
`count_issues`	Devuelve el recuento de problemas
`add_issue`	Crea un nuevo problema en el proyecto especificado
`update_issue`	Actualiza un problema existente
`delete_issue`	Elimina un problema

Herramientas para comentarios

Nombre de la herramienta	Descripción
`get_issue_comments`	Devuelve una lista de comentarios para un problema
`add_issue_comment`	Añade un comentario a un problema.

Herramientas Wiki

Nombre de la herramienta	Descripción
`get_wiki_pages`	Devuelve la lista de páginas Wiki
`get_wikis_count`	Devuelve el recuento de páginas wiki en un proyecto
`get_wiki`	Devuelve información sobre una página wiki específica
`add_wiki`	Crea una nueva página wiki

Herramientas de categoría

Nombre de la herramienta	Descripción
`get_categories`	Devuelve una lista de categorías para un proyecto

Herramientas de notificación

Nombre de la herramienta	Descripción
`get_notifications`	Devuelve la lista de notificaciones
`count_notifications`	Devuelve el recuento de notificaciones
`reset_unread_notification_count`	Restablecer el recuento de notificaciones no leídas
`mark_notification_as_read`	Marcar una notificación como leída

Herramientas del repositorio Git

Nombre de la herramienta	Descripción
`get_git_repositories`	Devuelve una lista de repositorios Git para un proyecto
`get_git_repository`	Devuelve información sobre un repositorio Git específico

Herramientas de solicitud de extracción

Nombre de la herramienta	Descripción
`get_pull_requests`	Devuelve la lista de solicitudes de extracción para un repositorio
`get_pull_requests_count`	Devuelve el recuento de solicitudes de extracción para un repositorio
`get_pull_request`	Devuelve información sobre una solicitud de extracción específica
`add_pull_request`	Crea una nueva solicitud de extracción
`update_pull_request`	Actualiza una solicitud de extracción existente
`get_pull_request_comments`	Devuelve la lista de comentarios para una solicitud de extracción
`add_pull_request_comment`	Agrega un comentario a una solicitud de extracción
`update_pull_request_comment`	Actualiza un comentario en una solicitud de extracción

Herramientas de observación

Nombre de la herramienta	Descripción
`get_watching_list_items`	Devuelve una lista de elementos observados por un usuario
`get_watching_list_count`	Devuelve el recuento de elementos vistos por un usuario

Ejemplos de uso

Una vez configurado el servidor MCP en los agentes de IA, podrá usar las herramientas directamente en sus conversaciones. A continuación, se muestran algunos ejemplos:

Listado de proyectos

Could you list all my Backlog projects?

Crear un nuevo problema

Create a new bug issue in the PROJECT-KEY project with high priority titled "Fix login page error"

Obtener detalles del proyecto

Show me the details of the PROJECT-KEY project

Trabajar con repositorios Git

List all Git repositories in the PROJECT-KEY project

Gestión de solicitudes de extracción

Show me all open pull requests in the repository "repo-name" of PROJECT-KEY project

Create a new pull request from branch "feature/new-feature" to "main" in the repository "repo-name" of PROJECT-KEY project

Observando objetos

Show me all items I'm watching 

i18n / Descripciones de reemplazo

Puede anular las descripciones de las herramientas creando un archivo .backlog-mcp-serverrc.json en su directorio de inicio .

El archivo debe contener un objeto JSON con los nombres de las herramientas como claves y las nuevas descripciones como valores.
Por ejemplo:

{
  "TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "An alternative description",
  "TOOL_CREATE_PROJECT_DESCRIPTION": "Create a new project in Backlog"
}

Cuando se inicia el servidor, determina la descripción final de cada herramienta según la siguiente prioridad:

Variables de entorno (por ejemplo, BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION )
Entradas en .backlog-mcp-serverrc.json : formatos de archivos de configuración admitidos: .json, .yaml, .yml
Valores de respaldo integrados (en inglés)

Configuración de muestra:

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "-v", "/yourcurrentdir/.backlog-mcp-serverrc.json:/root/.backlog-mcp-serverrc.json:ro",
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

Exportación de traducciones actuales

Puede exportar las traducciones predeterminadas actuales (incluida cualquier anulación) ejecutando el binario con el indicador --export-translations.

Esto imprimirá todas las descripciones de las herramientas en la salida estándar, incluidas todas las personalizaciones que haya realizado.

Ejemplo:

docker run -i --rm ghcr.io/nulab/backlog-mcp-server node build/index.js --export-translations

npx github:nulab/backlog-mcp-server --export-translations

Uso de una plantilla de traducción al japonés

Se proporciona un archivo de configuración japonés de muestra en:

translationConfig/.backlog-mcp-serverrc.json.example

Para usarlo, cópielo a su directorio de inicio como .backlog-mcp-serverrc.json:

Luego puede editar el archivo para personalizar las descripciones según sea necesario.

Uso de variables de entorno

Alternativamente, puede anular las descripciones de herramientas a través de variables de entorno.

Los nombres de las variables de entorno se basan en las claves de herramientas, tienen el prefijo BACKLOG_MCP_ y están escritos en mayúsculas.

Ejemplo: Para anular TOOL_ADD_ISSUE_COMMENT_DESCRIPTION:

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "BACKLOG_DOMAIN",
        "-e", "BACKLOG_API_KEY",
        "-e", "BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION"
        "ghcr.io/nulab/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "An alternative description"
      }
    }
  }
}

El servidor carga el archivo de configuración sincrónicamente al iniciarse.

Las variables de entorno siempre tienen prioridad sobre el archivo de configuración.

Desarrollo

Ejecución de pruebas

npm test

Agregar nuevas herramientas

Crea un nuevo archivo en src/tools/ siguiendo el patrón de las herramientas existentes
Crear un archivo de prueba correspondiente
Agregue la nueva herramienta a src/tools/tools.ts
Construya y pruebe sus cambios

Licencia

Este proyecto está licenciado bajo la licencia MIT .

Tenga en cuenta: esta herramienta se proporciona bajo la licencia MIT sin ninguna garantía ni soporte oficial .
Úselo bajo su propio riesgo después de revisar el contenido y determinar su idoneidad para sus necesidades.
Si encuentra algún problema, infórmelo a través de Problemas de GitHub .

Backlog MCP Server

Integrations