Backlog MCP Server 61l

Backlog MCP Server是一个用于与Backlog API交互的模型上下文协议服务器，提供项目管理、问题跟踪、Wiki页面管理等功能，支持通过AI代理操作Backlog平台。

开发者工具版本控制 #项目管理 #API集成 #AI代理 #协作工具本地 .TypeScript

评分 : 2分

下载量 : 9.2K

更新时间 : 2025-04-23

打开站点

什么是Backlog MCP服务器？

Backlog MCP服务器是一个通过AI代理（如Claude Desktop、Cline等）管理Backlog项目、问题、维基页面等功能的工具。

如何使用Backlog MCP服务器？

您可以通过Docker或手动安装方式配置MCP服务器，并使用其提供的多种工具来管理Backlog项目。

适用场景

适用于需要高效管理Backlog项目的开发团队，尤其是集成AI代理的协作场景。

主要功能

项目管理

支持创建、读取、更新和删除Backlog项目。

问题跟踪

创建、更新、删除问题以及查看问题列表。

维基页面管理

管理Backlog中的维基页面。

Git仓库管理

管理与Backlog项目相关的Git仓库。

优势

与Backlog API深度集成

支持多种AI代理工具

优化响应性能

局限性

需要Backlog账户及API访问权限

对网络环境有一定依赖

如何使用

安装Docker

确保您的系统已安装Docker。

配置MCP服务器

根据Backlog账户信息设置环境变量。

启动MCP服务器

运行Docker容器或本地脚本。

使用案例

列出所有项目

请求显示当前Backlog空间内的所有项目。

创建新问题

在指定项目中创建一个新的问题。

常见问题

如何安装MCP服务器？

是否支持多语言描述？

安装

复制以下命令到你的Client进行配置

{
  "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"
      }
    }
  }
}

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

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "--pull", "always",
        "-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"
      }
    }
  }
}

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

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 backlog - MCP 服务器工具

backlog - MCP 服务器工具是一款功能强大的项目管理辅助工具，它能帮助用户快速创建项目、高效管理问题和 Wiki 内容，还支持文件存储和集成开发。同时，工具提供了灵活的配置方式和国际化支持，满足不同用户的多样化需求。

🚀 快速开始

您可以使用 backlog - MCP 服务器快速创建新的项目，还能利用其丰富功能对项目进行管理和开发。

✨ 主要特性

创建项目：您可以使用 backlog - MCP 服务器快速创建新的项目。
问题跟踪：该工具支持通过 CSV 文件或直接 API 请求批量导入和管理问题。
Wiki 管理：能够通过 CSV 文件或 REST API 导入和更新 Wiki 内容。
文件存储：提供将文件上传到 Backlog 的功能，并且支持对上传的文件进行管理。
集成开发：该工具为开发者提供了丰富的接口，方便与其他系统进行深度集成。

📦 安装指南

以下是使用 Docker 运行 backlog - MCP 服务器的示例配置：

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

如果您需要自定义配置，可以参考以下 JSON 格式的配置文件：

{
  "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"
      }
    }
  }
}

💻 使用示例

基础用法

工具描述的国际化 - 使用配置文件

在您的用户主目录下创建或修改 .backlog-mcp-serverrc.json 文件，添加以下内容以覆盖工具描述：

{
  "TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "添加问题评论",
  "TOOL_CREATE_PROJECT_DESCRIPTION": "创建新项目"
}

支持的文件格式包括：.json、.yaml 和 .yml。

工具描述的国际化 - 使用环境变量

您还可以通过设置环境变量来覆盖工具描述，例如：

BACKLOG_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION=添加问题评论
BACKLOG_MCP_TOOL_CREATE_PROJECT_DESCRIPTION=创建新项目

这些环境变量需要以 BACKLOG_MCP_ 为前缀，并且使用大写字母。

高级用法

运行测试

npm test

添加新工具

在 src/tools/ 目录下创建新的工具文件，遵循现有工具的命名规范。
创建对应的测试文件。
将新工具添加到 src/tools/tools.ts 文件中。
构建并测试您的更改。

命令行选项使用

--export-translations：导出所有翻译键和值
--optimize-response：启用 GraphQL 风格字段选择
--max-tokens=NUMBER：设置响应的最大令牌限制

示例：

node build/index.js --optimize-response --max-tokens=100000

📚 详细文档

工具描述的国际化（i18n）

为了满足不同语言需求，您可以自定义工具描述。具体方法如下：

使用配置文件：在您的用户主目录下创建或修改 .backlog-mcp-serverrc.json 文件，添加相应内容以覆盖工具描述，支持的文件格式包括：.json、.yaml 和 .yml。
使用环境变量：通过设置以 BACKLOG_MCP_ 为前缀且使用大写字母的环境变量来覆盖工具描述。