Gitee MCP Server

Gitee MCP Server

MCP を通じて、AI に Gitee のリポジトリ／Issue／Pull Request を操作させることができます

---

対応している AI 操作

カテゴリ	MCP ツール	説明
リポジトリ操作	create_repository	Gitee リポジトリを作成します
	fork_repository	Gitee リポジトリをフォークします
ブランチ操作	create_branch	Gitee リポジトリに新しいブランチを作成します
	list_branches	Gitee リポジトリのブランチを一覧表示します
	get_branch	Gitee リポジトリの特定のブランチの詳細を取得します
ファイル操作	get_file_contents	Gitee リポジトリ内のファイルまたはディレクトリの内容を取得します
	create_or_update_file	Gitee リポジトリ内のファイルを作成または更新します
	push_files	複数のファイルを Gitee リポジトリにプッシュします
Issue 操作	create_issue	Gitee リポジトリに Issue を作成します
	list_issues	Gitee リポジトリの Issue を一覧表示します
	get_issue	Gitee リポジトリ内の特定の Issue の詳細を取得します
	update_issue	Gitee リポジトリの Issue を更新します
	add_issue_comment	Gitee リポジトリの Issue にコメントを追加します
Pull Request 操作	create_pull_request	Gitee リポジトリに Pull Request を作成します
	list_pull_requests	Gitee リポジトリの Pull Request を一覧表示します
	get_pull_request	Gitee リポジトリ内の特定の Pull Request の詳細を取得します
	update_pull_request	Gitee リポジトリの Pull Request を更新します
	merge_pull_request	Gitee リポジトリの Pull Request をマージします
ユーザー操作	get_user	Gitee ユーザー情報を取得します
	get_current_user	認証済み Gitee ユーザーの情報を取得します

使用方法

Smithery 経由でインストールする

Smithery 経由で Claude Desktop に Gitee MCP Server を自動的にインストールするには：

npx -y @smithery/cli install @normal-coder/gitee-mcp-server --client claude

設定

• GITEE_API_BASE_URL：任意。Gitee OpenAPI エンドポイント。デフォルトは https://gitee.com/api/v5 です
• GITEE_PERSONAL_ACCESS_TOKEN：必須。Gitee アカウントのパーソナルアクセストークン（PAT）。Gitee アカウント設定の Personal Access Tokens から取得できます
• DEBUG：任意。デバッグログを有効にするには true に設定します。デフォルトでは無効です

NPX 経由で MCP サーバーを実行する

{
  "mcpServers": {
    "Gitee": {
      "command": "npx",
      "args": [
        "-y",
        "gitee-mcp-server"
      ],
      "env": {
        "GITEE_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Docker コンテナ経由で MCP サーバーを実行する

1. Docker イメージを取得する

# Get from DockerHub
docker pull normalcoder/gitee-mcp-server

# Build locally
docker build -t normalcoder/gitee-mcp-server .

2. MCP サーバーを設定する

{
  "mcpServers": {
    "Gitee": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITEE_PERSONAL_ACCESS_TOKEN",
        "normalcoder/gitee-mcp-server"
      ],
      "env": {
        "GITEE_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

開発ガイド

依存関係をインストールする

npm install

ビルド

npm run build

ビルドが成功すると、/dist に実行可能な MCP サーバーが生成されます。

サーバーを実行する

npm start

MCP サーバーは stdio で実行されるため、MCP クライアントのサブプロセスとして使用できます。

Docker イメージをビルドする

Docker を使ってサーバーを実行することもできます：

docker build -t normalcoder/gitee-mcp-server .

Docker で MCP サーバーを実行します：

docker run -e GITEE_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> normalcoder/gitee-mcp-server

MCP サーバーをデバッグする

デバッグには @modelcontextprotocol/inspector を使用できます：

環境変数を設定するため、ルートディレクトリに .env ファイルを作成します：

GITEE_API_BASE_URL=https://gitee.com/api/v5
GITEE_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN>

デバッグツールを実行して、サービスとウェブデバッグインターフェースを起動します：

npx @modelcontextprotocol/inspector npm run start --env-file=.env

このプロジェクトには、デバッグ情報を出力する debug() 関数が含まれています。使用方法：

import { debug } from './common/utils.js';

debug('Message to log');
debug('Message with data:', { key: 'value' });

デバッグログは、DEBUG 環境変数が true に設定されている場合にのみ出力されます。

依存関係

• @modelcontextprotocol/sdk：サーバー実装用の MCP SDK
• universal-user-agent：ユーザーエージェント文字列の生成用
• zod：スキーマ検証用
• zod-to-json-schema：Zod スキーマを JSON スキーマに変換するためのライブラリ

ライセンス

MIT License の下でライセンスされています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。

関連リンク

• Model Context Protocol
• Gitee