mcpField
G
Gitscrum Studio Mcp Server

Gitscrum Studio Mcp Server

本地服务
github.com/gitscrum-core生产力53 周前更新

关于 Gitscrum Studio Mcp Server

Gitscrum Studio MCP Server 将 AI 助手连接到 GitScrum 工作区,支持项目与客户管理。29 个工具涵盖规划、协作、账单和报告,并采用 OAuth 设备授权流程。

主要功能

  1. 01管理任务、冲刺和工作流
  2. 02跟踪工时与项目预算
  3. 03处理讨论、Wiki 和笔记
  4. 04管理客户、发票和提案
  5. 05查看分析、动态和站会
  6. 06OAuth 设备授权

适用场景

  1. 01创建冲刺并分配待办任务
  2. 02查看项目预算和工时报告
  3. 03管理客户发票与提案
  4. 04检查阻塞项和团队动态

MCP 相关

通过托管 SSE 或本地 stdio 传输,向 MCP 客户端开放 GitScrum 工作区操作。认证使用 OAuth 2.0 设备授权流程。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"gitscrum-core": {
"command": "npx",
"args": [
"-y",
"@gitscrum-studio/mcp-server"
]
}
}
}
启动命令npx -y @gitscrum-studio/mcp-server

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@gitscrum-studio/mcp-server

工具

29

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

GitScrum

GitScrum MCP 服务:让你的 AI Agent 成为项目经理 🚀

npm 版本 MIT 许可证 测试

将你的 AI Agent 打造成全能项目经理。
GitScrum 官方 Model Context Protocol(MCP)服务为 AI 助手(Claude、Cursor、Windsurf、Copilot)提供丰富的上下文信息,并赋予其对整个项目技术栈的操作权限。

GitScrum MCP 服务

⚡ 托管版(推荐)

零安装,随处可用。

https://mcp.gitscrum.com/sse

托管在 AWS 上的 SSE 服务。只需将 URL 和令牌添加到你的 AI 客户端即可。

最适合: Claude Desktop、Cursor、Windsurf 以及任何兼容 SSE 的客户端。

→ 设置指南

📦 本地版(npm)

通过 npx 自托管。

npx -y @gitscrum-studio/mcp-server

通过 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%。

核心
工具操作文档
taskmy today get create update complete subtasks filter by_code duplicate move notifications任务
sprintlist all get kpis create update stats reports progress metrics冲刺
workspacelist get项目
projectlist get stats tasks workflows types efforts labels members项目
timeactive start stop logs analytics team reports productivity timeline时间跟踪
规划
工具操作文档
user_storylist get create update all用户故事
epiclist create update史诗
labellist create update attach detach toggle标签
task_typelist create update assign任务类型
workflowcreate update工作流
协作
工具操作文档
discussionall channels channel messages send search unread mark_read create_channel update_channel讨论
commentlist add update评论
wikilist get create update searchwiki
notelist get create update share revisionsnotevault
note_folderlist create update movenotevault
search—搜索
ClientFlow CRM
工具操作文档
clientlist get create update contacts interactions add_interactionclientflow
invoicelist get stats create update issue send mark_paidclientflow
proposallist get stats create update send approve reject convertclientflow
clientflow_dashboard8 份报告clientflow
clientflow_cross_workspace4 份报告clientflow
洞察 PRO
工具操作文档
standupsummary completed blockers team stuck digest contributors站会
analytics10 份报告分析
activityfeed user_feed notifications activities task_workflow活动
budgetprojects_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 构建

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。