MCP Git Tools

🚀 MCP Git ツール

MCP Git は、Git リポジトリとのやり取りを簡素化するための強力なツールです。このツールは、コミット、プル、プッシュ、リセットなどの一般的な Git 操作を実行するための様々なコマンドを提供します。

🚀 クイックスタート

MCP Git ツールを使うことで、Git リポジトリとのやり取りを簡単に行うことができます。以下に、基本的な使い方を紹介します。

✨ 主な機能

• git コミット：新しいコミットを作成します。
• git プル：リモートリポジトリから最新の変更を取得します。
• git プッシュ：ローカルの変更をリモートリポジトリにプッシュします。
• git リセット：指定されたコミットまたはブランチにリセットします。
• git 差分表示：ファイル間の差分を表示します。
• git 追加：ファイルをステージングエリアに追加します。
• git 復元：ファイルの変更を取り消します。

📦 インストール

MCP Git ツールを使用するには、以下の手順でインストールしてください。

1. ツールパッケージをダウンロードします。
2. ファイルを解凍し、システムパスに追加します。

💻 使用例

基本的な使用法

独立サーバーとして実行する場合

# リポジトリをクローンする
git clone https://github.com/username/repository.git

# リポジトリディレクトリに移動する
cd repository

# 変更をコミットする
git commit -m "コミットメッセージ"

# 変更をプッシュする
git push origin main

MCP クライアントで使用する場合

# クライアントを初期化する
client = GitClient(path_to_repository)

# ファイルをステージングエリアに追加する
client.add("file1.txt")

# 変更をコミットする
commit_info = client.commit(message="コミットメッセージ")

# 最新の変更をプルする
pull_result = client.pull()

# 変更をプッシュする
push_result = client.push(remote="origin", branch="main")

カスタムサーバーに統合する場合

// Git リポジトリを初期化する
Git git = Git.init();

// ファイルを追加する
git.add().addFilepattern("file1.txt").call();

// 変更をコミットする
git.commit().setMessage("コミットメッセージ").call();

// 最新の変更をプルする
git.pull().setRemoteName("origin").setBranchName("main").call();

📚 ドキュメント

git コミット

機能: 新しいコミットを作成します。
パラメータ:

• repo_path: リポジトリのパス。
• message: コミットメッセージ。
• all: すべての変更ファイルを自動的にステージングするかどうか（オプション、デフォルトは false）。

戻り値:

{
  "success": true,
  "hash": "abcd1234",
  "message": "feat: 新機能の追加"
}

git プル

機能: リモートリポジトリから最新の変更を取得します。
パラメータ:

• repo_path: リポジトリのパス。
• remote: リモート名（オプション、デフォルトは "origin"）。
• branch: ブランチ名（オプション、デフォルトは現在のブランチ）。

戻り値:

{
  "success": true,
  "remote": "origin",
  "output": "更新が完了しました"
}

git プッシュ

機能: ローカルの変更をリモートリポジトリにプッシュします。
パラメータ:

• repo_path: リポジトリのパス。
• remote: リモート名（オプション、デフォルトは "origin"）。
• branch: ブランチ名（オプション、デフォルトは現在のブランチ）。
• force: 強制的にプッシュするかどうか（オプション、デフォルトは false）。

戻り値:

{
  "success": true,
  "remote": "origin",
  "output": "リモートリポジトリにプッシュしました"
}

git リセット

機能: ファイルまたはステージングエリアを指定された状態にリセットします。
パラメータ:

• repo_path: リポジトリのパス。
• path: リセットするファイルまたはパス（オプション、デフォルトは現在のディレクトリ）。
• hard: ハードリセットを実行するかどうか（警告: すべてのローカル変更が失われます）（オプション、デフォルトは false）。

戻り値:

{
  "success": true,
  "message": "ファイルがリセットされました"
}

git 差分表示

機能: 指定されたファイルの差分を表示します。
パラメータ:

• repo_path: リポジトリのパス。
• file_name: 差分を確認するファイル名。

戻り値:

{
  "diff": "+ 行1\n- 行2"
}

git 追加

機能: ファイルをステージングエリアに追加します。
パラメータ:

• repo_path: リポジトリのパス。
• file_name: 追加するファイル名。

戻り値:

{
  "success": true,
  "message": "ファイルがステージングエリアに追加されました"
}

📄 ライセンス

MCP Git ツールは MIT ライセンスに従っており、ユーザーはこのツールを自由に使用、変更、配布することができます。