Gitrama Mcp

🌿 Gitrama MCP サーバー

IDE 向けの AI を活用した Git インテリジェンス — スマートコミット、ブランチ名、PR の説明、差分、コードレビュー、プッシュ、ワークフロー管理に対応します。

これは何ですか？

Gitrama MCP サーバーは、Gitrama の CLI を、あらゆる AI アシスタントが使える 15 個の MCP ツールとして公開します。ターミナルで gtr commit と入力する代わりに、AI アシスタントがツールを直接呼び出し、コードの変更を分析してコミットメッセージを生成したり、ブランチ名を提案したり、コードをレビューしたりできます。

対応環境： Cursor · Claude Desktop · Claude Code · Windsurf · VS Code · Zed · MCP 対応のあらゆるクライアント

v1.3.2 の新機能

• 5 つの新しいツール — gitrama_scan、gitrama_diff、gitrama_review、gitrama_status、gitrama_push
• ヘルスチェックでバージョンを表示 — gitrama_health が MCP サーバーのバージョンを返すようになり、実行中のバージョンを正確に確認できます
• インタラクティブな HTML 差分パネル — gitrama_diff はブラウザパネルを起動し、リスク注釈付きの差分、変更頻度、結合のコンテキスト、コントリビューター情報を変更された各ファイルに重ねて表示します
• チャットからプッシュ — gitrama_push はアップストリーム追跡、force-with-lease に対応し、現在のブランチを自動解決します
• ツール数を 10 から 15 に更新

インストール（60 秒未満）

ステップ 1：パッケージをインストール

pip install gitrama-mcp

または uv を使用：

uv pip install gitrama-mcp

これにより、MCP サーバーと gitrama CLI の両方がインストールされます。

ステップ 2：IDE に接続

{
  "mcpServers": {
    "gitrama": {
      "command": "gitrama-mcp"
    }
  }
}

{
  "mcpServers": {
    "gitrama": {
      "command": "gitrama-mcp"
    }
  }
}

claude mcp add gitrama gitrama-mcp

{
  "mcpServers": {
    "gitrama": {
      "command": "gitrama-mcp"
    }
  }
}

{
  "mcpServers": {
    "gitrama": {
      "command": "gitrama-mcp"
    }
  }
}

{
  "context_servers": {
    "gitrama": {
      "command": {
        "path": "gitrama-mcp"
      }
    }
  }
}

ステップ 3：完了です。

AI に 「ステージングした変更をコミットして」 と頼むと、gitrama_commit が呼び出されます。

ツール（15 個）

ヘルスチェックと診断

リポジトリのインテリジェンス

コードレビューと差分

コミットインテリジェンス

ブランチとプッシュの管理

PR と変更履歴

ストリーム（ワークフロー）の管理

ツールの詳細

gitrama_health

AI サーバーへの接続を確認し、実行中の MCP サーバーのバージョンを確認します。

プロンプトの例： 「gitrama のヘルスチェックを実行して」

出力例：

✅ AI server is healthy!
   🤖 Model: grok-4.20-reasoning
   🌐 Connected to: https://api.x.ai/v1
 
🔖 Gitrama MCP Server: v1.3.2

gitrama_scan

リポジトリの構造的な健全性を全面的にスキャンします。各ファイルについて、連続性のリスク、境界エントロピー、繰り返しパターンをスコア化します。結果は last_scan.json にキャッシュされ、gtr diff と gtr review で使用されます。

プロンプトの例： 「リポジトリ全体を gitrama でスキャンして」

gitrama_diff

現在の変更のリスク注釈付き差分を表示します。Gitrama の構造分析情報（リスクスコア、変更頻度、結合のギャップ、変更された各ファイルの貢献者情報）を重ねて表示するインタラクティブな HTML ブラウザーパネルを開きます。

パラメーター：

プロンプトの例：

• 「ステージ済みの変更の差分を表示して」
• 「ブランチと main の差分を表示して」

gitrama_review

コミット前に、現在の変更を AI でコードレビューします。セキュリティ、正確性、リスク、結合に関する重要度別の指摘に加え、判定と推奨するコミットメッセージを返します。

パラメーター：

プロンプトの例：

• 「ステージ済みの変更をレビューして」
• 「未コミットの変更をすべて完全にレビューして」

gitrama_push

現在のブランチをリモートリポジトリにプッシュします。安全な強制プッシュには --force-with-lease を使用し、ブランチが指定されていない場合は現在のブランチを自動的に解決します。

パラメーター：

プロンプトの例：

• 「変更をプッシュして」
• 「このブランチをプッシュして、アップストリームも設定して」
• 「現在のブランチを強制プッシュして」

gitrama_status

ステージ済み、未ステージ、未追跡のファイルについて AI による解釈を加えて、作業ツリーの状態を表示します。

プロンプトの例： 「現在の git の状態は？」

gitrama_ask

リポジトリについて自然言語で質問できます。Gitrama はコミット履歴、ファイル構造、blame データ、差分を分析して回答します。

パラメーター：

プロンプトの例：

• 「認証モジュールの担当者は誰？」
• 「このリポジトリで最もリスクの高いファイルは？」
• 「過去 3 日間で何が変更された？」
• 「src/utils/retry.py の目的を説明して」

gitrama_commit

ステージ済みの変更に対する AI 生成のコミットメッセージを作成します。

パラメーター：

プロンプトの例： 「ステージ済みの変更をコミットして」

gitrama_stage_and_commit

ファイルをステージングして、1 回の操作でコミットします。

パラメーター：

プロンプトの例： 「変更をすべてステージングしてコミットして」

gitrama_unstage

変更を破棄せずに、ファイルをステージングエリアから削除します。

パラメーター：

プロンプトの例： 「src/auth.py のステージングを解除して」

gitrama_branch

説明から AI を活用したブランチ名を生成し、必要に応じてブランチを作成します。

パラメーター：

プロンプトの例：

• 「OAuth2 サポートを追加するブランチを作成して」
• 「支払いタイムアウトを修正するブランチ名を提案して。作成はしないで」

gitrama_pr

現在のブランチとベースブランチの差分から PR の説明を生成します。

パラメーター：

プロンプトの例： 「このブランチの PR の説明を書いて」

gitrama_changelog

参照間の変更履歴を生成します。

パラメーター：

プロンプトの例： 「v1.1.4 以降の変更履歴を生成して」

ストリームツール

v1.3.2 のワークフロー

15 個のツールすべてを接続すると、チャットから開発の全工程を実行できます。

describe intent  →  stream switch
write code
ask gitrama what changed  →  diff (HTML panel)
review before push
commit with AI message
push
PR description generated

ターミナルも、手動の git コマンドも不要です。

設定

環境変数

HTTP トランスポート（CI/CD 向け）

GTR_MCP_TRANSPORT=streamable-http GTR_MCP_PORT=8765 gitrama-mcp

その後、クライアントを http://localhost:8765/mcp に接続します。

必要条件

• Python 3.10+
• Git がインストールされ、PATH に設定されていること
• Gitrama API キーまたはローカルの Ollama インスタンス

API キーを設定します：

gtr config --key YOUR_API_KEY

または、ローカルモデルを使用します：

gtr config --provider ollama --model llama3

開発

git clone https://github.com/ahmaxdev/gitrama-mcp.git
cd gitrama-mcp
pip install -e ".[dev]"
 
# Test with MCP Inspector
mcp dev src/gitrama_mcp/server.py

ライセンス

プロプライエタリ — LICENSE を参照してください。

Alfonso Harding によって作成 · gitrama.ai

🌿