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

  • 使用关键字执行 wikis get

• backlog_get_wiki

  • 使用 wiki id 或 key 执行 wiki gets

• backlog_add_wiki

  • 使用 wiki 数据执行 wiki add

• backlog_update_wiki

  • 使用 wiki 数据执行 wiki 更新

• backlog_delete_wiki

  • 使用 wiki id 或 key 执行 wiki 删除

Related MCP server: MCP Server Linear

配置

获取 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 文件。