Backlog MCP Qsd

🚀 Backlog MCP 服务器

Backlog MCP 服务器是为 Backlog 接口提供支持的消息通信代理（MCP，Message Communication Proxy）服务器，它能助力用户高效管理项目、任务等，提升工作效率。

✨ 主要特性

支持功能

• 项目管理：可轻松获取项目相关信息。
• 任务管理：能对任务进行创建、更新、删除等操作。
• 搜索功能：可依据条件筛选任务。
• 状态管理：能处理项目状态相关操作。
• 用户信息：可获取用户资料。

支持的 Backlog 版本

• Standard Plan
• Professional Plan

📚 详细文档

工具说明

项目相关工具

getSpaces

• 功能：取得可用的空间（项目）列表。
• 输入：无。
• 输出：返回包含空间信息的数据结构。

getProjects

• 功能：获取特定空间内的所有项目。
• 输入：指定空间 ID 或名称。
• 输出：返回对应空间下的项目列表。

任务相关工具

createIssue

• 功能：创建新任务。
• 输入：任务标题、内容、优先级等参数。
• 输出：返回新建任务的详细信息。

updateIssue

• 功能：更新现有任务的信息。
• 输入：任务 ID 与需要修改的字段。
• 输出：返回更新后的任务详情。

deleteIssue

• 功能：删除指定任务。
• 输入：任务 ID。
• 输出：确认删除成功状态。

搜索相关工具

searchIssues

• 功能：根据条件搜索任务。
• 输入：关键词、项目 ID、状态 ID、指派者 ID 等筛选条件。
• 输出：返回符合筛选条件的任务列表。

📦 安装指南

环境变量配置

在 .env 文件中添加以下内容：

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

# 测试环境配置（可选）
TEST_PROJECT_ID=your-test-project-id
TEST_PROJECT_KEY=your-test-project-key

在 Claude Desktop 中使用

将以下配置添加到 claude_desktop_config.json 文件：

使用 NPX 的情况

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

💻 使用示例

本地运行指令

# 执行构建
npm run build

# 启动服务
npm start

测试指令

# 运行所有测试
npm test

# 启动监视模式进行测试
npm run test:watch

# 带覆盖率报告的测试运行
npm run test:coverage

📄 许可证

此 MCP 服务器基于 MIT 许可证发布。详细许可信息请参阅项目仓库中的 LICENSE 文件。