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 页面的摘要

先决条件

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

发展

安装依赖项：

构建服务器：

自动重建开发：

安装

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

MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%/Claude/claude_desktop_config.json

调试

MCP 服务器通过标准输入和输出进行通信，因此很难调试。我们建议使用MCP 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 - 从环境变量加载配置