Gitscrum

com.gitscrum由 gitscrum.com 发布v1.0.2更新于 Oct 24, 2026

MCP server for GitScrum — manage tasks, sprints, time tracking, and client workflows via AI

已验证STDIO仅桌面效率与工作流沟通与协作商业与电商

概览

AI 生成的概览

GitScrum MCP 服务器，让 AI 助手在 GitScrum 工作区中管理项目、任务、迭代、工时、Wiki 笔记和客户 CRM。

可以做什么
管理任务、迭代、工作区和项目，包括子任务、标签、任务类型和工作流，以及工时记录与报表。规划工作，处理用户故事、史诗和标签。通过讨论、频道、评论、Wiki 页面、笔记和搜索进行协作。处理客户 CRM 记录、发票、提案和仪表盘。读取站会摘要、分析、活动流和预算风险报告。通过设备码认证工具登录和退出 GitScrum。
适用场景
适合已在 GitScrum 中管理项目、工时和客户工作的团队，希望助手在对话中查询和更新这些数据，而不必切换到网页应用。
运行要求
以 npm 包形式通过 stdio 在本地运行，需要 Node.js 18 及以上和 npm 8 及以上。需要 GITSCRUM_API_URL 提供 GitScrum API 基础地址，以及 GITSCRUM_TOKEN 中的认证令牌，或通过 OAuth 设备码流程登录。文档还提到托管的 SSE 端点。
安装前请注意
助手可以创建和更新项目、任务、讨论、Wiki、笔记、客户、发票和提案等记录，并可发送发票和提案。文档称删除操作被阻止，破坏性操作需在 GitScrum 中完成。GITSCRUM_TOKEN 中的令牌可访问整个工作区，并保存在本地文件系统中。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Gitscrum，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[GitScrum]

GitScrum MCP Server: Your AI Agent as a Project Manager 🚀

[npm version] [MIT License] [Tests]

Turn your AI Agent into a full-scale Project Manager.
The Official Model Context Protocol (MCP) server for GitScrum provides AI assistants (Claude, Cursor, Windsurf, Copilot) with deep context and operational access to your entire project stack.


⚡ Hosted (Recommended)

Zero install. Works everywhere.

https://mcp.gitscrum.com/sse

SSE-based server hosted on AWS. Just add URL + token to your AI client.

Best for: Claude Desktop, Cursor, Windsurf, any SSE-compatible client.

→ Setup Guide

📦 Local (npm)

Self-hosted via npx.

bash
npx -y @gitscrum-studio/mcp-server

Runs locally via stdio transport. Requires Node.js 18+.

Best for: VS Code, GitHub Copilot, offline environments.

→ Local Setup

Overview

GitScrum Studio MCP Server connects AI assistants to your GitScrum workspace via the Model Context Protocol. It gives Claude, GitHub Copilot, Cursor, and any MCP-compatible client full operational access to your project management stack — tasks, sprints, time tracking, user stories, epics, kanban workflows, team discussions, wiki, notes, client CRM, invoicing, proposals, budget tracking, analytics dashboards, standup reports, and activity feeds.

Everything your team does in the GitScrum web app, your AI assistant can now do through conversation.

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 tools. 160+ operations. Zero context switching.

Quick start

Install

bash
npx -y @gitscrum-studio/mcp-server

Configure your client

Claude Desktop

Edit the configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "gitscrum": {      "command": "npx",      "args": ["-y", "@gitscrum-studio/mcp-server"]    }  }}
VS Code / Cursor

Add to .vscode/mcp.json or your MCP settings:

json
{  "servers": {    "gitscrum": {      "command": "npx",      "args": ["-y", "@gitscrum-studio/mcp-server"]    }  }}

Authenticate

Tell your AI assistant: "Login to GitScrum"

The server initiates an OAuth 2.0 Device Authorization Grant flow. You authorize in the browser — credentials are never shared with the MCP server.

Tools

Each tool uses a consolidated action parameter, reducing LLM context tokens by ~80% compared to individual tool definitions.

Core

ToolActionsDocs
taskmy today get create update complete subtasks filter by_code duplicate move notificationstasks
sprintlist all get kpis create update stats reports progress metricssprints
workspacelist getprojects
projectlist get stats tasks workflows types efforts labels membersprojects
timeactive start stop logs analytics team reports productivity timelinetime-tracking

Planning

ToolActionsDocs
user_storylist get create update alluser-stories
epiclist create updateepics
labellist create update attach detach togglelabels
task_typelist create update assigntask-types
workflowcreate updateworkflows

Collaboration

ToolActionsDocs
discussionall channels channel messages send search unread mark_read create_channel update_channeldiscussions
commentlist add updatecomments
wikilist get create update searchwiki
notelist get create update share revisionsnotevault
note_folderlist create update movenotevault
search—search

ClientFlow CRM

ToolActionsDocs
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 reportsclientflow
clientflow_cross_workspace4 reportsclientflow

Insights PRO

ToolActionsDocs
standupsummary completed blockers team stuck digest contributorsstandup
analytics10 reportsanalytics
activityfeed user_feed notifications activities task_workflowactivity
budgetprojects_at_risk overview consumption burn_down alerts eventsbudget

Authentication

ToolDescriptionDocs
auth_loginInitiate device code flowauth
auth_completeComplete authorizationauth
auth_statusCheck session statusauth
auth_logoutClear stored credentialsauth

Full reference: docs/TOOLS.md

Security

The server is designed around the principle of least privilege.

LayerProtection
OperationsOnly CREATE, READ, UPDATE. DELETE is blocked at MCP and API layers.
AuthenticationOAuth 2.0 Device Grant — credentials never touch the server.
Token storageLocal filesystem with restricted permissions.
Rate limitingAutomatic lockout after failed auth attempts.

Destructive operations must be performed in the GitScrum Studio.

Full details: docs/SECURITY.md

Found a vulnerability? Report privately to [email protected].

Documentation

Hosted ServerSSE setup for Claude, Cursor, Windsurf, and more
Usage GuidePractical examples and common workflows
Tools ReferenceAll 29 tools with parameters and response shapes
Per-Tool GuidesDeep-dive into each tool module
SecuritySecurity model, token handling, threat mitigations
DevelopmentLocal setup, architecture, testing, contribution
ChangelogVersion history and migration notes

Development

bash
git clone https://github.com/gitscrum-core/mcp-server.gitcd mcp-servernpm installnpm run buildnpm test          # 378 tests across 22 suites

Inspect locally with the MCP Inspector:

bash
npx @modelcontextprotocol/inspector node dist/index.js
RequirementVersion
Node.js>= 18.0.0
npm>= 8.0.0

Full guide: docs/DEVELOPMENT.md

Contributing

See CONTRIBUTING.md for guidelines.

bash
git checkout -b feature/my-feature# make changes, add testsnpm testgit commit -m "feat: describe your change"

License

MIT — see LICENSE.

Website  ·  Docs  ·  Issues  ·  Changelog

Built by GitScrum

来源：README.md，提交 800279c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分