mcp-backlog-服务器

Backlog MCP 服务器

这是一个基于 TypeScript 的服务器，它将 Backlog 与模型上下文协议 (MCP) 集成在一起。它实现了 MCP 的以下关键概念：

代表 Backlog 项目的资源（包括 URI 和元数据）
与 Backlog API 交互的工具
提示生成 Backlog 数据的摘要和分析

功能

资源

通过backlog://project/[id] URI 访问 Backlog 项目
每个项目资源都包含项目元数据和详细信息
用于结构化数据访问的 JSON 格式资源
访问项目中的问题
访问项目中的 Wiki 页面

工具

get_backlog_user - 获取当前 Backlog 用户信息
get_backlog_space - 获取 Backlog 空间信息
list_recent_projects - 列出最近查看的 Backlog 项目
- 可以设置数量和排序顺序
get_project_issues - 获取项目的问题
- 按状态、受让人、分页等进行过滤。
get_issue_detail - 获取有关特定问题的详细信息
get_issue_comments - 获取问题的评论
add_issue_comment - 向问题添加评论
get_issue_comment_count - 获取某个问题的评论数量
get_issue_comment - 获取有关特定评论的详细信息
get_wiki_page_list - 获取 Wiki 页面列表
- 按项目或关键字过滤
get_wiki_page - 获取有关特定 wiki 页面的详细信息
update_wiki_page - 更新 Wiki 页面

迅速的

summarize_projects - 生成最近查看的 Backlog 项目的摘要
analyze_backlog_usage - 根据用户、空间和项目数据分析 Backlog 使用模式
summarize_wiki_pages - 生成项目 Wiki 页面的摘要

Related MCP server: Linear MCP Server

先决条件

具有 API 访问权限的 Backlog 帐户
环境变量：
- BACKLOG_API_KEY ：Backlog API 密钥
- BACKLOG_SPACE_URL ：Backlog 空间 URL（例如https://your-space.backlog.com ）

发展

安装依赖项：

npm install

构建服务器：

npm run build

自动重建开发：

npm run watch

安装

要与 Claude Desktop 一起使用，请添加您的服务器配置：

MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json 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"
      }
    }
  }
}

调试

MCP 服务器通过标准输入和输出进行通信，因此很难调试。我们建议使用MCP Inspector 。这可以作为包脚本使用：

npm run inspector

Inspector 提供了一个 URL 来访问浏览器中的调试工具。

技术细节

该服务器由以下主要组件组成：

index.ts - 主入口点，初始化并配置 MCP 服务器
backlog-client.ts - 处理与 Backlog API 通信的客户端。
handlers/ ——资源、工具和提示处理程序
- resource-handlers.ts - 项目、问题和 wiki 的资源处理程序
- tool-handlers.ts - 与 Backlog API 交互的工具
- prompt-handlers.ts - 提示生成函数
types.ts - Backlog API 响应的类型定义
config.ts - 从环境变量加载配置