Gitee MCP Server

Gitee MCP サーバー

Gitee MCP サーバーは、Gitee 向けの Model Context Protocol（MCP）サーバー実装です。Gitee の API と連携するためのツール一式を提供し、AI アシスタントがリポジトリ、Issue、プルリクエストなどを管理できます。

機能

• Gitee のリポジトリ、Issue、プルリクエスト、通知を操作できます
• さまざまな Gitee インスタンスに対応できるよう、API のベース URL を設定できます
• 簡単に設定できるコマンドラインフラグ
• 個人、組織、エンタープライズの各操作に対応
• ツールセットの動的な有効化／無効化

実践的なシナリオ：リポジトリから Issue を取得し、実装してプルリクエストを作成する

1. リポジトリの Issue を取得する
2. Issue の詳細に基づいて実装し、プルリクエストを作成する
3. Issue にコメントしてクローズする

インストール

リモート MCP サーバーはインストール不要で、すぐに利用できます。mcp-gitee をローカルで（stdio で）実行するには、以下のいずれかの方法を選んでください。

リモート MCP サーバー（推奨）

ホストの設定にある mcpServers セクションに以下を追加し、<your personal access token> をこちらで取得したトークンに置き換えてください。

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      }
    }
  }
}

クライアントごとの設定ファイルのパスと形式（Claude Code、Codex、Cursor、Trae、Cline、Continue、opencode）については、以下の「MCP ホストの設定」セクションにあるガイドを参照してください。

ローカル（stdio）

ビルド済みバイナリをダウンロードする

ご利用のプラットフォーム（linux-amd64 / linux-arm / darwin-amd64 / darwin-arm64 / windows-amd64）用のアーカイブをリリースからダウンロードして展開し、mcp-gitee を PATH に追加してください（Windows では実行ファイル名は mcp-gitee.exe です）。

npx を使用する

インストールは不要です。ご利用のプラットフォーム用のビルド済みバイナリが、起動時に自動でダウンロードされます。

{
  "mcpServers": {
    "gitee": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee@latest"
      ],
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

ソースからビルドする

Go 1.23.0 以降が必要です。

1. リポジトリをクローンします。

   git clone https://gitee.com/oschina/mcp-gitee.git
   cd mcp-gitee
   

2. プロジェクトをビルドします。

   make build
   

   ./bin/mcp-gitee を PATH 環境変数に移動します

go install を使用する

go install gitee.com/oschina/mcp-gitee@latest

インストール済みの実行ファイルを使用する

（リリース、ソースからのビルド、または go install により）mcp-gitee が PATH から利用できるようになったら、次のように設定します。

{
  "mcpServers": {
    "gitee": {
      "command": "mcp-gitee",
      "env": {
        "GITEE_API_BASE": "https://gitee.com/api/v5",
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

Windows：実行ファイルには .exe サフィックスが必要です。また、command のパスにはスラッシュ / を使用してください（Windows でも使用でき、JSON のバックスラッシュのエスケープミスを防げます）。

{
  "mcpServers": {
    "gitee": {
      "command": "C:/Users/<you>/bin/mcp-gitee.exe",
      "env": {
        "GITEE_ACCESS_TOKEN": "<your personal access token>"
      }
    }
  }
}

MCP ホストの設定

設定例：クリックしてその他のアプリケーション設定を表示

• Claude Code
• Codex
• Cursor
• Trae
• Cline
• Continue
• opencode

コマンドラインオプション

• --token：Gitee アクセストークン
• --api-base：Gitee API のベース URL（デフォルト：https://gitee.com/api/v5）
• --version：バージョン情報を表示
• --transport：トランスポートの種類（stdio、sse、http。デフォルト：stdio）
• --address：サーバーを起動するホストとポート（デフォルト：localhost:8000）
• --enabled-toolsets：有効にするツールのカンマ区切りリスト（指定した場合、これらのツールのみが有効になります）
• --disabled-toolsets：無効にするツールのカンマ区切りリスト

環境変数

環境変数を使ってサーバーを設定することもできます。

• GITEE_ACCESS_TOKEN：Gitee アクセストークン
• GITEE_API_BASE：Gitee API のベース URL
• ENABLED_TOOLSETS：有効にするツールのカンマ区切りリスト
• DISABLED_TOOLSETS：無効にするツールのカンマ区切りリスト

ツールセットの管理

ツールセットの管理では、次の 2 つのモードをサポートしています。

1. 指定したツールを有効にする（許可リストモード）：

   • --enabled-toolsets パラメーターまたは ENABLED_TOOLSETS 環境変数を使用します
   • 指定すると、リストに記載されたツールのみが有効になり、その他は無効になります
   • 例：--enabled-toolsets="list_user_repos,get_file_content"

2. 指定したツールを無効にする（ブロックリストモード）：

   • --disabled-toolsets パラメーターまたは DISABLED_TOOLSETS 環境変数を使用します
   • 指定すると、リストに記載されたツールが無効になり、その他は有効になります
   • 例：--disabled-toolsets="list_user_repos,get_file_content"

注意：

• enabled-toolsets と disabled-toolsets の両方を指定した場合は、enabled-toolsets が優先されます
• ツール名では大文字と小文字が区別されます

リクエストごとのツールフィルタリング（HTTP ヘッダー）

リモート MCP サーバー（HTTP/SSE トランスポート）を使用する場合、HTTP ヘッダーを使ってリクエストごとに利用可能なツールを動的にフィルタリングできます。これは、サーバーを再起動せずにツールの公開範囲を細かく制御する必要があるクライアントに便利です。

1. ヘッダーで指定したツールを有効にする（許可リスト）：

   • X-MCP-Enabled-Tools ヘッダーを使用します
   • そのリクエストでは、リストに記載されたツールのみが有効になります
   • 例：X-MCP-Enabled-Tools: list_user_repos,get_file_content

2. ヘッダーで指定したツールを無効にする（ブロックリスト）：

   • X-MCP-Disabled-Tools ヘッダーを使用します
   • そのリクエストでは、リストに記載されたツールが無効になります
   • 例：X-MCP-Disabled-Tools: create_repo,delete_repo

優先順位のルール：

• 同じリクエストに X-MCP-Enabled-Tools と X-MCP-Disabled-Tools の両方が含まれる場合は、許可リスト（X-MCP-Enabled-Tools）が優先されます
• ツール名では大文字と小文字が区別されます

Cursor/Claude の設定例：

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>",
        "X-MCP-Enabled-Tools": "list_user_repos,get_file_content,list_repo_issues"
      }
    }
  }
}

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。

利用可能なツール

このサーバーでは、Gitee と連携するためのさまざまなツールを利用できます。

ツール	カテゴリ	説明
list_user_repos	リポジトリ	ユーザーがアクセスを許可したリポジトリの一覧を取得します
get_file_content	リポジトリ	リポジトリ内のファイルの内容を取得します
create_repo	リポジトリ	リポジトリを作成します（ユーザー、組織、またはエンタープライズ）
fork_repository	リポジトリ	リポジトリをフォークします
create_release	リポジトリ	リポジトリのリリースを作成します
list_releases	リポジトリ	リポジトリのリリース一覧を取得します
search_open_source_repositories	リポジトリ	Gitee 上のオープンソースリポジトリを検索します
search_files_by_content	リポジトリ	リポジトリ内のファイルを内容で検索します
compare_branches_tags	リポジトリ	リポジトリ内の 2 つのブランチ、タグ、またはコミットを比較します
list_repo_pulls	プルリクエスト	リポジトリのプルリクエスト一覧を取得します
merge_pull	プルリクエスト	プルリクエストをマージします
create_pull	プルリクエスト	プルリクエストを作成します
update_pull	プルリクエスト	プルリクエストを更新します
get_pull_detail	プルリクエスト	プルリクエストの詳細を取得します
get_diff_files	プルリクエスト	プルリクエストの差分ファイルを取得します
manage_pull_review	プルリクエスト	プルリクエストのレビューを管理します（承認または取り消し）
create_comment	コメント	イシューまたはプルリクエストにコメントを作成します
list_comments	コメント	イシューまたはプルリクエストのコメントをすべて取得します
create_issue	イシュー	イシューを作成します
update_issue	イシュー	イシューを更新します
get_repo_issue_detail	イシュー	リポジトリのイシューの詳細を取得します
list_repo_issues	イシュー	リポジトリのイシュー一覧を取得します
get_user_info	ユーザー	認証済みユーザーの現在の情報を取得します
search_users	ユーザー	ユーザーを検索します
list_user_notifications	通知	ユーザーの通知一覧を取得します

コントリビューション

オープンソースコミュニティからのコントリビューションを歓迎します！このプロジェクトに貢献する場合は、次のガイドラインに従ってください。

1. リポジトリをフォークします。
2. 機能追加またはバグ修正用の新しいブランチを作成します。
3. 変更を加え、コードに十分なドキュメントが記載されていることを確認します。
4. 変更内容を明確に説明して、プルリクエストを送信します。

詳しくは、CONTRIBUTING ファイルを参照してください。