Mooring — Git & GitHub MCPサーバー

License: MIT

コードのための係留ロープ — AIツール向けのGitおよびGitHub操作。

Mooringは、AIアシスタントにローカルGitリポジトリおよびGitHub APIへの構造化されたアクセスを提供するMCPサーバーです。ローカル操作にはGitPythonを使用します（サブプロセス呼び出しは行いません）。GitHub操作にはPyGithubライブラリを使用し、トークンのマスキングとレート制限の処理が組み込まれています。

ツール

ローカルGit

ツール	説明	主要パラメータ
`repo_status`	ブランチ、先行/遅延、スタッシュ数、ステージング済み/未ステージング/追跡対象外ファイル	`repo_path`
`repo_log`	フィルタ付きコミットログ	`repo_path`, `max_count`, `author`, `since`, `path`, `search`
`repo_diff`	ユニファイド差分 — ワーキングツリー、ステージング済み、または参照間	`repo_path`, `staged`, `from_ref`, `to_ref`
`repo_blame`	行範囲指定可能なGit blame	`repo_path`, `file_path`, `start_line`, `end_line`
`repo_branches`	追跡情報、最終コミット、先行/遅延を含む全ブランチ	`repo_path`
`repo_stash`	スタッシュ操作: 一覧表示、プッシュ、ポップ、適用	`repo_path`, `action`, `message`

GitHub

ツール	説明	主要パラメータ
`gh_pr_list`	プルリクエストの一覧表示	`repo`, `state`, `author`, `label`
`gh_pr_detail`	レビュー、コメント、チェック実行を含むPR詳細	`repo`, `number`
`gh_pr_create`	プルリクエストの作成	`repo`, `title`, `body`, `head`, `base`, `labels`, `reviewers`
`gh_issues`	Issueの一覧表示、作成、更新	`repo`, `state`, `action`, `title`, `body`, `number`
`gh_actions`	最近のGitHub Actionsワークフロー実行の一覧表示	`repo`, `workflow`, `status`

ユーティリティ

ツール	説明	主要パラメータ
`health`	サーバーのバージョンとステータスチェック	(なし)

インストール

# PyPI
pip install mooring-mcp

# Isolated install
pipx install mooring-mcp

使用方法

サーバーを直接実行します:

mooring

Claude Code

claude mcp add mooring -- mooring

Claude Desktop

Claude Desktopの設定ファイル (claude_desktop_config.json) に追加します:

{
  "mcpServers": {
    "mooring": {
      "command": "mooring",
      "env": {
        "GITHUB_TOKEN": "your-github-personal-access-token"
      }
    }
  }
}

すべてのGitHubツール (gh_*) には GITHUB_TOKEN 環境変数が必要です。ローカルGitツールはこれなしでも動作します。

セキュリティ

パストラバーサル保護 — ファイルパスは解決され、操作前にリポジトリルートに対して検証されます
シンボリックリンクエスケープ検出 — リポジトリ外を指すシンボリックリンクは拒否されます
参照（Ref）の検証 — Gitの参照は安全な文字パターンと照合され、使用前に存在が確認されます
トークンマスキング — エラーメッセージは、返される前にGitHubトークンのパターン (ghp_*, gho_*, github_pat_*) がスクラブされます
レート制限の処理 — GitHubの403レスポンスはキャッチされ、生の例外ではなく明確なメッセージとして表示されます

開発

git clone https://github.com/seayniclabs/mooring.git
cd mooring
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
python -m pytest tests/ -q