[!警告] 正式发布 Backlog MCP 服务器！

该仓库将变为可见状态。

https://nulab.com/ja/blog/backlog/released-backlog-mcp-server/

Backlog MCP 服务器

一个集成 Backlog API 的 MCP 服务器实现。

工具

项目 API

• backlog_get_projects
  • 执行带有分页和过滤的项目获取操作
• backlog_get_project
  • 执行带有项目ID或键的项目获取操作

问题 API

• backlog_get_issues
  • 执行带有分页和过滤的问题获取操作
• backlog_get_issue
  • 执行带有问题ID或键的问题获取操作
• backlog_add_issue
  • 执行带有问题数据的问题添加操作
• backlog_update_issue
  • 执行带有问题数据的问题更新操作
• backlog_delete_issue
  • 执行带有问题ID或键的问题删除操作

维基 API

• backlog_get_wikis
  • 执行带有关键词的维基获取操作
• backlog_get_wiki
  • 执行带有维基ID或键的维基获取操作
• backlog_add_wiki
  • 执行带有维基数据的维基添加操作
• backlog_update_wiki
  • 执行带有维基数据的维基更新操作
• backlog_delete_wiki
  • 执行带有维基ID或键的维基删除操作

配置

获取 API 密钥

1. 注册 Backlog
2. 选择一个计划（免费计划可在此处获得 这里）
3. 从个人设置中生成您的 API 密钥 帮助

环境变量

此服务器需要以下环境变量：

• 必需：
  • BACKLOG_API_KEY：您的 Backlog API 密钥
  • BACKLOG_SPACE_ID：您的 Backlog 空间ID
• 可选：
  • BACKLOG_BASE_URL：您的 Backlog 基础URL（默认值：https://{your-space-id}.backlog.com/api/v2）

使用 Claude Desktop

在您的 claude_desktop_config.json 中添加以下内容：

NPX

{
  "mcpServers": {
    "backlog": {
      "command": "npx",
      "args": [
        "-y",
        "backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_API_KEY": "YOUR_API_KEY_HERE",
        "BACKLOG_SPACE_ID": "YOUR_SPACE_ID_HERE"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "backlog": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BACKLOG_API_KEY=YOUR_API_KEY_HERE",
        "-e",
        "BACKLOG_SPACE_ID=_YOUR_SPACE_ID_HERE",
        "mcp/backlog"
      ],
      "env": {
        "BACKLOG_API_KEY": "YOUR_API_KEY_HERE",
        "BACKLOG_SPACE_ID": "YOUR_SPACE_ID_HERE"
      }
    }
  }
}

开发

安装

npm install

构建

npm run build

调试

npm run debug

运行测试

待定

Docker 构建

docker build -t mcp/backlog -f Dockerfile .

扩展服务器

要添加新工具：

1. 在 src/core/schema.ts 中定义一个新的 Zod 模式
2. 在 src/tools/toolDefinitions.ts 中添加一个新的工具定义，并将其包含在 ALL_TOOLS 中
3. 在 src/tools/handlers.ts 中创建一个新的处理器，并将其注册到 toolHandlers
4. 在 src/services/ 目录下的服务中实现业务逻辑

许可证

此 MCP 服务器根据 MIT 许可证授权。这意味着您可以自由使用、修改和分发软件，但须遵守 MIT 许可证中的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。