Backlog MCP 服务器

一个用于与 Backlog API 交互的模型上下文协议 (MCP) 服务器。此服务器提供通过 Claude 管理 Backlog 中的项目、问题、Wiki 页面等的工具。

功能

• 项目管理（创建、读取、更新、删除）
• 问题跟踪（创建、更新、删除、列表）
• Wiki 页面管理
• 更多 Backlog API 集成

要求

• Node.js (v16 或更高版本)
• 具有 API 访问权限的 Backlog 帐户
• 来自您的 Backlog 帐户的 API 密钥

安装

选项 1：通过 npx 安装

使用此 MCP 服务器的最简单方法是通过 Claude 的 MCP 配置：

1. 打开 Claude 设置
2. 导航到 MCP 配置部分
3. 添加以下配置：

{
  "mcpServers": {
    "backlog": {
      "command": "npx",
      "args": [
        "-y",
        "github:trknhr/backlog-mcp-server"
      ],
      "env": {
        "BACKLOG_DOMAIN": "your-domain.backlog.com",
        "BACKLOG_API_KEY": "your-api-key"
      }
    }
  }
}

将 your-domain.backlog.com 替换为您的 Backlog 域名，将 your-api-key 替换为您的 Backlog API 密钥。

选项 2：手动安装

1. 克隆存储库：

   git clone https://github.com/trknhr/backlog-mcp-server.git
   cd backlog-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 创建一个包含您的 Backlog 凭据的 .env 文件：

   BACKLOG_DOMAIN=your-domain.backlog.com
   BACKLOG_API_KEY=your-api-key
   

5. 启动服务器：

   npm start
   

可用工具

该服务器提供以下工具来与 Backlog 交互：

工具名称	描述
get_project_list	返回项目列表
add_issue	在指定项目中创建一个新问题
add_project	创建一个新项目
get_project	返回有关特定项目的信息
update_project	更新现有项目
delete_project	删除一个项目
get_wiki_pages	返回 Wiki 页面列表

使用示例

在 Claude 中配置 MCP 服务器后，您可以直接在对话中使用这些工具。以下是一些示例：

列出项目

你能列出我所有的 Backlog 项目吗？

创建一个新问题

在 PROJECT-KEY 项目中创建一个新的高优先级错误问题，标题为“修复登录页面错误”

获取项目详细信息

向我展示 PROJECT-KEY 项目的详细信息

开发

运行测试

npm test

添加新工具

1. 在 src/tools/ 中创建一个新文件，遵循现有工具的模式
2. 创建相应的测试文件
3. 将新工具添加到 src/tools/tools.ts
4. 构建并测试您的更改

许可证

MIT