AI-powered Git intelligence for your IDE
🌿 Gitrama MCP Server
AI-powered Git intelligence for your IDE — smart commits, branch names, PR descriptions, changelogs, and workflow management.
What is this?
Gitrama MCP Server exposes Gitrama's CLI as 10 MCP tools that any AI assistant can use. Instead of typing gtr commit in your terminal, your AI assistant calls the tool directly — analyzing your code changes, generating commit messages, suggesting branch names, and more.
Works with: Cursor · Claude Desktop · Claude Code · Windsurf · VS Code (Copilot) · Zed · any MCP-compatible client
Install (< 60 seconds)
Step 1: Install the package
pip install gitrama-mcp
Or with uv:
uv pip install gitrama-mcp
This installs both the MCP server and the gitrama CLI.
Step 2: Connect to your IDE
Cursor
Add to .cursor/mcp.json in your project (or global settings):
{
"mcpServers": {
"gitrama": {
"command": "gitrama-mcp"
}
}
}
Claude Desktop
Add to claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"gitrama": {
"command": "gitrama-mcp"
}
}
}
Claude Code
claude mcp add gitrama gitrama-mcp
VS Code (Copilot)
Add to .vscode/settings.json:
{
"mcp": {
"servers": {
"gitrama": {
"command": "gitrama-mcp"
}
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"gitrama": {
"command": "gitrama-mcp"
}
}
}
Zed
Add to Zed settings (⌘,):
{
"context_servers": {
"gitrama": {
"command": {
"path": "gitrama-mcp"
}
}
}
}
Step 3: Done.
Ask your AI: "Commit my staged changes" — and watch it call gitrama_commit.
Tools (11)
Repository Intelligence
| Tool | Description |
|---|---|
gitrama_ask |
Ask any question about your repo — ownership, history, risk, changes |
Commit Intelligence
| Tool | Description |
|---|---|
gitrama_commit |
Generate an AI commit message for staged changes |
gitrama_stage_and_commit |
Stage files + commit in one step |
gitrama_commit_quality |
Analyze quality of recent commit messages |
Branch Management
| Tool | Description |
|---|---|
gitrama_branch |
Create a new branch |
gitrama_branch_suggest |
Get AI-suggested branch names from a description |
PR & Changelog
| Tool | Description |
|---|---|
gitrama_pr |
Generate a PR description from branch diff |
gitrama_changelog |
Generate a changelog between refs |
Stream (Workflow) Management
| Tool | Description |
|---|---|
gitrama_stream_status |
Show current workflow stream |
gitrama_stream_switch |
Switch to a different stream |
gitrama_stream_list |
List all streams in the repo |
Tool Details
`gitrama_ask`
Ask a natural language question about your repository. Gitrama analyzes commit history, file structure, blame data, and diffs to answer.
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
question |
string | required | Any question about your repo |
scope |
string | "auto" |
Context: "auto", "branch", "full", or "staged" |
model |
string | "" |
AI model override |
Example prompts:
- "Who owns the auth module?"
- "When did we last change the payment logic?"
- "What's the riskiest file in this repo?"
- "Summarize what happened on this branch"
- "What changed in the last 3 days?"
- "Explain the purpose of src/utils/retry.py"
`gitrama_commit`
Generate an AI-powered commit message for staged changes.
Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
message_type |
string | "conventional" |
Style: "conventional", "detailed", or "simple" |
context |
string | "" |
Optional context (e.g., "fixing auth bug") |
model |
string | "" |
AI model override (e.g., "gpt-4o", "claude-sonnet-4-20250514") |
Example prompt: "Commit my changes with a conventional message, context: refactoring the payment module"
`gitrama_stage_and_commit`
Stage files and comm
Tools (11)
gitrama_askAsk any question about your repo regarding ownership, history, risk, or changes.gitrama_commitGenerate an AI commit message for staged changes.gitrama_stage_and_commitStage files and commit in one step.gitrama_commit_qualityAnalyze quality of recent commit messages.gitrama_branchCreate a new branch.gitrama_branch_suggestGet AI-suggested branch names from a description.gitrama_prGenerate a PR description from branch diff.gitrama_changelogGenerate a changelog between refs.gitrama_stream_statusShow current workflow stream.gitrama_stream_switchSwitch to a different stream.gitrama_stream_listList all streams in the repo.Configuration
{"mcpServers": {"gitrama": {"command": "gitrama-mcp"}}}