中国語版
mcp-gitlab MCP サーバー (英語)
fastmcpフレームワーク上に構築されたGitLab統合サーバー。様々なGitLab RESTful APIツールを提供します。Claude、Smithery、その他のプラットフォームとの統合をサポートします。
特徴
- GitlabSearchUserProjectsTool : ユーザー名でユーザーとそのアクティブなプロジェクトを検索します
- GitlabGetUserTasksTool : 現在のユーザーの保留中のタスクを取得する
- GitlabSearchProjectDetailsTool : プロジェクトと詳細を検索
- GitlabCreateMRCommentTool : マージリクエストにコメントを追加する
- GitlabAcceptMRTool : マージリクエストを承認してマージする
- GitlabUpdateMRTool : マージリクエストの担当者、レビュー担当者、タイトル、説明、ラベルを更新する
- GitlabCreateMRTool : 担当者とレビュー担当者を含む新しいマージリクエストを作成する
- GitlabRawApiTool : カスタムパラメータを使用して任意の GitLab API を呼び出す
クイックスタート
# Install dependencies
bun install
# Build the project
bun run build
# Start the server
bun run start
環境変数
GITLAB_API_URL=https://your-gitlab-instance.com
GITLAB_TOKEN=your_access_token
# Optional: Provide a mapping from usernames to user IDs (JSON string)
# This can reduce API calls, especially when referencing the same users frequently
# Example: '{"username1": 123, "username2": 456}'
GITLAB_USER_MAPPING={"username1": 123, "username2": 456}
# Optional: Provide a mapping from project names to project IDs (JSON string)
# Project IDs can be numbers or strings (e.g., 'group/project')
# This can reduce API calls and ensure the correct project is used
# Example: '{"project-name-a": 1001, "group/project-b": "group/project-b"}'
GITLAB_PROJECT_MAPPING={"project-name-a": 1001, "group/project-b": "group/project-b"}
使用例
各ツールのパラメータの詳細な例については、 USAGE.md を参照してください。
プロジェクト構造
src/
├── server/
│ └── GitlabMCPServer.ts # MCP server entry point
├── tools/
│ ├── GitlabAcceptMRTool.ts
│ ├── GitlabCreateMRCommentTool.ts
│ ├── GitlabGetUserTasksTool.ts
│ ├── GitlabRawApiTool.ts
│ ├── GitlabSearchProjectDetailsTool.ts
│ ├── GitlabSearchUserProjectsTool.ts
│ └── gitlab/
│ ├── FieldFilterUtils.ts
│ ├── GitlabApiClient.ts
│ └── GitlabApiTypes.ts
├── utils/
│ ├── is.ts
│ └── sensitive.ts
smithery.json # Smithery config
USAGE.md # Usage examples
package.json
tsconfig.json
統合
クロード デスクトップ クライアント
設定に追加:
{
"mcpServers": {
"@zephyr-mcp/gitlab": {
"command": "npx",
"args": ["-y", "@zephyr-mcp/gitlab"]
}
}
}
鍛冶屋
Smithery プラットフォームで直接使用します:
smithery add @zephyr-mcp/gitlab
または、Smithery UI で「@zephyr-mcp/gitlab」を検索し、ワークスペースに追加します。
環境変数:
GITLAB_API_URL
: GitLab APIのベースURLGITLAB_TOKEN
: GitLab API認証用のアクセストークン
関連リンク