Gitee

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 にコメントしてクローズする

インストール

前提条件

• Go 1.23.0 以降
• アクセストークンを持つ Gitee アカウント、こちらから取得

ソースからビルドする

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

使用方法

mcp-gitee のバージョンを確認します：

mcp-gitee --version

MCP ホストの設定

Cursor、Windsurf の設定例：

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

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

• -token：Gitee アクセストークン
• -api-base：Gitee API のベース URL（デフォルト：https://gitee.com/api/v5）
• -version：バージョン情報を表示します
• -transport：トランスポートの種類（stdio または sse、デフォルト：stdio）
• -sse-address：SSE サーバーを起動するホストとポート（デフォルト：localhost:8000）

環境変数

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

• GITEE_ACCESS_TOKEN：Gitee アクセストークン
• GITEE_API_BASE：Gitee API のベース URL

ライセンス

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

利用可能なツール

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

ツール	カテゴリ	説明
list_user_repos	リポジトリ	ユーザーがアクセスを許可したリポジトリの一覧を取得
get_file_content	リポジトリ	リポジトリ内のファイルの内容を取得
create_user_repo	リポジトリ	ユーザーリポジトリを作成
create_org_repo	リポジトリ	組織リポジトリを作成
create_enter_repo	リポジトリ	エンタープライズリポジトリを作成
create_release	リポジトリ	リポジトリのリリースを作成
list_releases	リポジトリ	リポジトリのリリース一覧を取得
list_repo_pulls	プルリクエスト	リポジトリのプルリクエスト一覧を取得
merge_pull	プルリクエスト	プルリクエストをマージ
create_pull	プルリクエスト	プルリクエストを作成
update_pull	プルリクエスト	プルリクエストを更新
get_pull_detail	プルリクエスト	プルリクエストの詳細を取得
comment_pull	プルリクエスト	プルリクエストにコメント
list_pull_comments	プルリクエスト	プルリクエストのすべてのコメントを一覧表示
create_issue	イシュー	イシューを作成
update_issue	イシュー	イシューを更新
get_repo_issue_detail	イシュー	リポジトリのイシューの詳細を取得
list_repo_issues	イシュー	リポジトリのイシュー一覧を取得
comment_issue	イシュー	イシューにコメント
list_issue_comments	イシュー	イシューのコメント一覧を取得
get_user_info	ユーザー	現在認証されているユーザーの情報を取得
list_user_notifications	通知	ユーザーの通知一覧を取得

コントリビューション

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

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

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