mcp-backlog-server

mcp-backlog-server

site icon
2025.03.05 1
TypeScript项目管理团队协作交流协作
mcp-backlog-server 是一个基于TypeScript的服务器,用于将Backlog与Model Context Protocol (MCP)集成。它实现了MCP的主要概念,包括代表Backlog项目的资源、与Backlog API交互的工具以及生成Backlog数据摘要和分析的提示。
View on GitHub

Overview

基本能力

产品定位

mcp-backlog-server 是一个集成Backlog项目管理工具与MCP协议的服务器,旨在通过MCP协议提供对Backlog项目的结构化访问和操作能力。

核心功能

  1. 资源管理
  2. 通过backlog://project/[id] URI访问Backlog项目
  3. 包含项目元数据和详细信息
  4. 提供结构化数据访问(JSON格式)
  5. 访问项目中的问题和Wiki页面

  6. 工具集

  7. get_backlog_user: 获取当前Backlog用户信息
  8. get_backlog_space: 获取Backlog空间信息
  9. list_recent_projects: 列出最近查看的Backlog项目
  10. get_project_issues: 获取项目问题(可过滤)
  11. get_issue_detail: 获取特定问题详情
  12. get_issue_comments: 获取问题评论
  13. add_issue_comment: 添加问题评论
  14. get_wiki_page_list: 获取Wiki页面列表
  15. get_wiki_page: 获取特定Wiki页面详情
  16. update_wiki_page: 更新Wiki页面

  17. 提示功能

  18. summarize_projects: 生成最近查看项目的摘要
  19. analyze_backlog_usage: 分析Backlog使用模式
  20. summarize_wiki_pages: 生成Wiki页面摘要

适用场景

  • 需要自动化管理Backlog项目的团队
  • 需要集成Backlog数据到其他系统的场景
  • 需要生成Backlog项目分析和摘要的报告

使用教程

使用依赖

  1. 需要具备API访问权限的Backlog账户
  2. 需要设置以下环境变量:
  3. BACKLOG_API_KEY: Backlog API密钥
  4. BACKLOG_SPACE_URL: Backlog空间URL(如https://your-space.backlog.com

安装教程

  1. 安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发模式(自动重建):
npm run watch
  1. 在Claude Desktop中添加服务器配置:
  2. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

配置示例:

{
  "mcpServers": {
    "mcp-backlog-server": {
      "command": "/path/to/mcp-backlog-server/build/index.js",
      "env": {
        "BACKLOG_API_KEY": "your-api-key",
        "BACKLOG_SPACE_URL": "https://your-space.backlog.com"
      }
    }
  }
}

调试方式

  1. 使用MCP Inspector进行调试:
npm run inspector
  1. Inspector会提供浏览器访问调试工具的URL。

许可证

None