remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Enables AI to interact with Gitee repositories, including creating/managing repositories, branches, files, issues, and pull requests. Supports operations like pushing code, creating issues, managing PRs, and performing user-related actions on Gitee's platform.

Gitee MCP サーバー

MCP を通じて AI が Gitee リポジトリ/Issues/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リポジトリにプッシュする
発行業務	`create_issue`	Giteeリポジトリに問題を作成する
	`list_issues`	Giteeリポジトリの問題を一覧表示する
	`get_issue`	Giteeリポジトリ内の特定の問題の詳細を取得する
	`update_issue`	Giteeリポジトリの問題を更新する
	`add_issue_comment`	Giteeリポジトリの問題にコメントを追加する
プルリクエスト操作	`create_pull_request`	Giteeリポジトリにプルリクエストを作成する
	`list_pull_requests`	Giteeリポジトリ内のプルリクエストを一覧表示する
	`get_pull_request`	Giteeリポジトリ内の特定のプルリクエストの詳細を取得する
	`update_pull_request`	Giteeリポジトリのプルリクエストを更新する
	`merge_pull_request`	Giteeリポジトリにプルリクエストをマージする
ユーザー操作	`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アカウント設定の個人アクセストークンから取得できます。
DEBUG : オプション。デバッグログを有効にするにはtrueに設定し、デフォルトでは無効になっています。

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

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

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

Dockerイメージを取得する

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

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

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>

デバッグツールを実行して、サービスと Web デバッグインターフェースを開始します。

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ライセンスに基づきライセンスされています。MITライセンスの条件に従い、本ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

Gitee