关于 gitscrum-core
gitscrum-core 是连接 GitScrum 工作区与 AI 助手的 MCP 服务,面向需要通过对话管理项目工作的团队。它覆盖任务、冲刺、工时、协作及客户流程,并提供托管 SSE 与本地 stdio 接入。
主要功能
- 01管理任务、冲刺与项目
- 02跟踪工时并查看分析
- 03维护讨论、Wiki 和笔记
- 04处理客户、发票与提案
- 05查看预算、站会和活动报告
适用场景
- 01查询当天到期的任务
- 02创建冲刺并安排待办项
- 03检查项目预算消耗与风险
MCP 相关
通过 MCP 向兼容客户端提供 GitScrum 工作区的项目管理操作。可使用托管 SSE 端点或本地 stdio 运行,并通过 OAuth 2.0 设备授权登录。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
29收录的工具列表 · 更新于 2 周前
此工具无需参数。
详细介绍
GitScrum MCP 服务:让你的 AI Agent 成为项目经理 🚀
将你的 AI Agent 打造成全能项目经理。
GitScrum 官方 Model Context Protocol(MCP)服务为 AI 助手(Claude、Cursor、Windsurf、Copilot)提供丰富的上下文信息,并赋予其对整个项目技术栈的操作权限。
⚡ 托管版(推荐)零安装,随处可用。
托管在 AWS 上的 SSE 服务。只需将 URL 和令牌添加到你的 AI 客户端即可。 最适合: Claude Desktop、Cursor、Windsurf 以及任何兼容 SSE 的客户端。 |
📦 本地版(npm)通过 npx 自托管。
通过 stdio 传输在本地运行。需要 Node.js 18+。 最适合: VS Code、GitHub Copilot 和离线环境。 |
概览
GitScrum Studio MCP 服务通过 Model Context Protocol 将 AI 助手连接到你的 GitScrum 工作区。它让 Claude、GitHub Copilot、Cursor 以及任何兼容 MCP 的客户端能够全面操作你的项目管理工具栈,包括任务、冲刺、时间跟踪、用户故事、史诗、看板工作流、团队讨论、维基、笔记、客户 CRM、发票、提案、预算跟踪、分析仪表板、站会报告和活动动态。
团队在 GitScrum Web 应用中的所有操作,现在都可以由你的 AI 助手通过对话完成。
You: "What's on my plate today?"
Assistant: Fetches your tasks due today across all projects.
You: "Create a sprint for next week with the top 5 backlog items"
Assistant: Creates the sprint, assigns tasks, and sets the timeline.
You: "Show me which projects are over budget"
Assistant: Returns burn-down data and flags at-risk projects.
You: "Send the Q1 proposal to Acme Corp"
Assistant: Creates the proposal, attaches the client, and sends it.
You: "What did the team ship this week?"
Assistant: Generates a standup digest with completed work and blockers.
29 个工具、160 多项操作,无需切换上下文。
快速开始
安装
npx -y @gitscrum-studio/mcp-server
配置客户端
Claude Desktop
编辑配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"gitscrum": {
"command": "npx",
"args": ["-y", "@gitscrum-studio/mcp-server"]
}
}
}
VS Code / Cursor
添加到 .vscode/mcp.json 或你的 MCP 设置中:
{
"servers": {
"gitscrum": {
"command": "npx",
"args": ["-y", "@gitscrum-studio/mcp-server"]
}
}
}
身份验证
告诉你的 AI 助手:"登录 GitScrum"
服务会启动 OAuth 2.0 设备授权许可流程。你可在浏览器中完成授权,凭据绝不会共享给 MCP 服务。
工具
每个工具都使用整合的 action 参数,与单独定义各工具相比,可将 LLM 上下文令牌减少约 80%。
核心
| 工具 | 操作 | 文档 |
|---|---|---|
task | my today get create update complete subtasks filter by_code duplicate move notifications | 任务 |
sprint | list all get kpis create update stats reports progress metrics | 冲刺 |
workspace | list get | 项目 |
project | list get stats tasks workflows types efforts labels members | 项目 |
time | active start stop logs analytics team reports productivity timeline | 时间跟踪 |
规划
| 工具 | 操作 | 文档 |
|---|---|---|
user_story | list get create update all | 用户故事 |
epic | list create update | 史诗 |
label | list create update attach detach toggle | 标签 |
task_type | list create update assign | 任务类型 |
workflow | create update | 工作流 |
协作
| 工具 | 操作 | 文档 |
|---|---|---|
discussion | all channels channel messages send search unread mark_read create_channel update_channel | 讨论 |
comment | list add update | 评论 |
wiki | list get create update search | wiki |
note | list get create update share revisions | notevault |
note_folder | list create update move | notevault |
search | — | 搜索 |
ClientFlow CRM
| 工具 | 操作 | 文档 |
|---|---|---|
client | list get create update contacts interactions add_interaction | clientflow |
invoice | list get stats create update issue send mark_paid | clientflow |
proposal | list get stats create update send approve reject convert | clientflow |
clientflow_dashboard | 8 份报告 | clientflow |
clientflow_cross_workspace | 4 份报告 | clientflow |
洞察 PRO
| 工具 | 操作 | 文档 |
|---|---|---|
standup | summary completed blockers team stuck digest contributors | 站会 |
analytics | 10 份报告 | 分析 |
activity | feed user_feed notifications activities task_workflow | 活动 |
budget | projects_at_risk overview consumption burn_down alerts events | 预算 |
身份验证
| 工具 | 描述 | 文档 |
|---|---|---|
auth_login | 启动设备代码流程 | 身份验证 |
auth_complete | 完成授权 | 身份验证 |
auth_status | 检查会话状态 | 身份验证 |
auth_logout | 清除已存储的凭据 | 身份验证 |
完整参考:docs/TOOLS.md
安全
该服务遵循最小权限原则进行设计。
| 层级 | 防护措施 |
|---|---|
| 操作 | 仅允许 CREATE、READ、UPDATE。DELETE 在 MCP 和 API 层均被阻止。 |
| 身份验证 | OAuth 2.0 Device Grant — 凭据不会接触服务端。 |
| 令牌存储 | 使用权限受限的本地文件系统。 |
| 速率限制 | 身份验证尝试失败后自动锁定。 |
破坏性操作必须在 GitScrum Studio 中执行。
完整详情:docs/SECURITY.md
发现漏洞?请私下发送邮件至 [email protected]。
文档
| 托管服务 | 为 Claude、Cursor、Windsurf 等配置 SSE |
| 使用指南 | 实用示例和常见工作流 |
| 工具参考 | 全部 29 个工具及其参数和响应结构 |
| 各工具指南 | 深入介绍每个工具模块 |
| 安全 | 安全模型、令牌处理、威胁缓解 |
| 开发 | 本地设置、架构、测试、贡献 |
| 更新日志 | 版本历史和迁移说明 |
开发
git clone https://github.com/gitscrum-core/mcp-server.git
cd mcp-server
npm install
npm run build
npm test # 378 tests across 22 suites
使用 MCP Inspector 在本地检查:
npx @modelcontextprotocol/inspector node dist/index.js
| 要求 | 版本 |
|---|---|
| Node.js | >= 18.0.0 |
| npm | >= 8.0.0 |
完整指南:docs/DEVELOPMENT.md
贡献
请参阅 CONTRIBUTING.md 了解相关指南。
git checkout -b feature/my-feature
# make changes, add tests
npm test
git commit -m "feat: describe your change"
许可证
MIT — 请参阅 LICENSE。
由 GitScrum 构建
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。