Gitee Enterprise MCP Server

Gitee Enterprise MCP サーバー

Gitee Enterprise MCP サーバーは、Gitee Enterprise 向けの Model Context Protocol（MCP）サーバー実装です。Gitee Enterprise API と連携するためのツールセットを提供し、AI アシスタントがエンタープライズのリポジトリ、課題、プルリクエストなどを管理できるようにします。

機能

• Gitee Enterprise のリポジトリ、課題、プルリクエストを操作
• エンタープライズレベルの操作と管理に対応
• さまざまな Gitee Enterprise インスタンスに対応するため、API ベース URL を設定可能
• SSE と Stdio のトランスポートに対応
• ツールセットの動的な有効化／無効化

シナリオ例

1. 特定のエンタープライズ課題を取得
2. 課題の内容を改善
3. サブタスクに分割
4. PR を作成／PR をレビュー

インストール（npx で起動する場合、この手順は省略できます）

前提条件

• Go 1.23.0 以降
• MCP トークン、取得はこちら

ソースからビルド

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

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

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

   make build
   

   ./bin/mcp-gitee-ent を PATH 環境変数に追加します

go install を使用

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

使用方法

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

mcp-gitee-ent --version

MCP ホストの設定

設定例：

• npx

{
  "mcpServers": {
    "gitee-ent": {
      "command": "npx",
      "args": [
        "-y",
        "@gitee/mcp-gitee-ent@latest"
      ],
      "env": {
         "GITEE_ENT_API_BASE": "https://api.gitee.com/enterprises",
         "GITEE_ENT_MCP_ACCESS_TOKEN": "<your mcp ent access token>"
      }
    }
  }
}

• 実行可能ファイル

{
  "mcpServers": {
    "gitee-ent": {
      "command": "mcp-gitee-ent",
      "env": {
        "GITEE_ENT_API_BASE": "https://api.gitee.com/enterprises",
        "GITEE_ENT_MCP_ACCESS_TOKEN": "<your mcp ent access token>",
      }
    }
  }
}

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

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

環境変数

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

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

ツールセットの管理

ツールセットの管理には、次の 2 つのモードがあります：

1. 指定したツールを有効化（ホワイトリストモード）：

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

2. 指定したツールを無効化（ブラックリストモード）：

   • --disabled-toolsets パラメーターまたは DISABLED_TOOLSETS 環境変数を使用します
   • 指定すると、リストにあるツールが無効になり、それ以外は有効になります
   • 例：--disabled-toolsets="update_enterprise_issue,list_enterprise_repositories"

注：

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

利用可能なツール

サーバーは、Gitee Enterprise と連携するためのさまざまなツールを提供しています。

Tool	Category	Description
list_enterprises	Enterprise	ユーザーの企業を一覧表示します
list_enterprise_repositories	Repository	企業内のリポジトリを一覧表示します
create_enterprise_repository	Repository	企業内にリポジトリを作成します
create_enterprise_repo_release	Repository	リポジトリのリリースを作成します
list_enterprise_repo_releases	Repository	リポジトリのリリースを一覧表示します
get_enterprise_repository_file_content	Repository	リポジトリ内の特定のファイルの内容を取得します
get_enterprise_repo_tree	Repository	リポジトリのツリー構造を取得します
list_enterprise_pulls	Pull Request	企業のプルリクエストを一覧表示します
create_enterprise_repo_pull	Pull Request	リポジトリのプルリクエストを作成します
merge_enterprise_pull	Pull Request	プルリクエストをマージします
get_enterprise_pull_detail	Pull Request	プルリクエストの詳細を取得します
update_enterprise_pull	Pull Request	プルリクエストを更新します
get_enterprise_pull_diff	Pull Request	プルリクエストの差分を取得します
comment_enterprise_pull	Pull Request	プルリクエストにコメントします
list_enterprise_pull_comments	Pull Request	プルリクエストのコメントを一覧表示します
create_enterprise_issue	Issue	イシューを作成します
update_enterprise_issue	Issue	イシューを更新します
get_enterprise_issue_detail	Issue	イシューの詳細を取得します
list_enterprise_issues	Issue	イシューを一覧表示します
comment_enterprise_issue	Issue	イシューにコメントします
list_enterprise_issue_comments	Issue	イシューのコメントを一覧表示します
get_user_info	User	ユーザー情報を取得します
list_enterprise_members	Member	企業のメンバーを一覧表示します
list_enterprise_groups	Group	企業内のグループを一覧表示します
list_enterprise_labels	Label	企業のラベルを一覧表示します
list_programs	Program	企業のプログラムを一覧表示します
list_scrum_sprints	Program	Scrum スプリントを一覧表示します
create_scrum_sprint	Program	Scrum スプリントを作成します
list_scrum_versions	Program	Scrum バージョンを一覧表示します
list_issue_types	Issue Type	イシューの種類を一覧表示します
list_issue_type_states	Issue State	イシューの状態を一覧表示します

貢献

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

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

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