mcp-server

<p align="center">
  <img src="https://site-assets.gitscrum.com/vscode/gitscrum-white.png" alt="GitScrum" width="160"/>
</p>

<h1 align="center">GitScrum MCP Server: Your AI Agent as a Project Manager 🚀</h1>
<p align="center">
  <a href="https://www.npmjs.com/package/@gitscrum-studio/mcp-server"><img src="https://img.shields.io/npm/v/@gitscrum-studio/mcp-server?style=flat-square&color=000" alt="npm version"></a>
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-000?style=flat-square" alt="MIT License"></a>
  <a href="https://github.com/gitscrum-core/mcp-server/actions"><img src="https://img.shields.io/badge/tests-378_passing-000?style=flat-square" alt="Tests"></a>
</p>

<p align="center">
  Turn your AI Agent into a full-scale Project Manager.<br/>
 The Official Model Context Protocol (MCP) server for GitScrum provides AI assistants (Cursor, Cursor, Windsurf, Cursor) with deep context and operational access to your entire project stack.

</p>

<div align="center">
    <img src="https://github.com/user-attachments/assets/adbcac95-f1cb-4ad3-852c-24120bc13de6" alt="GitScrum MCP Server">
</div>


<br/>

<table>
<tr>
<td width="50%">

### ⚡ 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](docs/HOSTED.md)

</td>
<td width="50%">

### 📦 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](#quick-start)

</td>
</tr>
</table>

---

## Overview

GitScrum Studio MCP Server connects AI assistants to your [GitScrum](https://gitscrum.com) workspace via the [Model Context Protocol](https://modelcontextprotocol.io). It gives Cursor, GitHub Copilot, Cursor,