
mcp-backlog-server

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项目的结构化访问和操作能力。
核心功能
- 资源管理
- 通过
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_wiki_page_list
: 获取Wiki页面列表get_wiki_page
: 获取特定Wiki页面详情-
update_wiki_page
: 更新Wiki页面 -
提示功能
summarize_projects
: 生成最近查看项目的摘要analyze_backlog_usage
: 分析Backlog使用模式summarize_wiki_pages
: 生成Wiki页面摘要
适用场景
- 需要自动化管理Backlog项目的团队
- 需要集成Backlog数据到其他系统的场景
- 需要生成Backlog项目分析和摘要的报告
使用教程
使用依赖
- 需要具备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 Inspector进行调试:
npm run inspector
- Inspector会提供浏览器访问调试工具的URL。
许可证
None