Gitee MCPサーバー

Gitee MCPサーバーは、Gitee向けのModel Context Protocol (MCP) サーバー実装です。GiteeのAPIと対話するためのツールセットを提供し、AIアシスタントがリポジトリ、Issue、プルリクエストなどを管理できるようにします。

機能

• Giteeのリポジトリ、Issue、プルリクエスト、通知との対話

• さまざまなGiteeインスタンスをサポートする設定可能なAPIベースURL

• 簡単な設定のためのコマンドラインフラグ

• 個人、組織、エンタープライズ操作の両方をサポート

• 動的なツールセットの有効化/無効化

1. リポジトリのIssueを取得

2. Issueの詳細に基づいてコーディングを行い、プルリクエストを作成

3. コメントしてIssueをクローズ

Related MCP server: Gitea MCP Tool

インストール (npxで起動する場合はこのステップをスキップ可能)

前提条件

• 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ホストの設定

設定例: その他のアプリケーション設定を表示するにはクリック

• 公式のリモートmcp-giteeサーバーに接続 (インストール不要)

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

• 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>"
      }
    }
  }
}

• 実行ファイル

{
  "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、または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 が優先されます

• ツール名はケースセンシティブです

ライセンス

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

利用可能なツール

サーバーはGiteeと対話するためのさまざまなツールを提供します:

貢献

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

1. リポジトリをフォークします。

2. 機能またはバグ修正のための新しいブランチを作成します。

3. 変更を加え、コードが十分に文書化されていることを確認します。

4. 変更内容を明確に記述したプルリクエストを送信します。

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