repocollab

repocollab

repocollab は、日常的な GitLab プロジェクトのワークフローを MCP サーバー経由で利用できるようにします。プロジェクトの検索や作成、フォーク、ブランチの作成、ファイルの読み書き、イシューやマージリクエストの作成と追跡ができます。GitLab MCP のドキュメントに記載された機能の中核的なサブセットであり、エージェントが最もよく使う 12 個のツールを備え、GitLab REST v4 API と通信します。

認証には GITLAB_PERSONAL_ACCESS_TOKEN のパーソナルアクセストークンを使用し、Bearer トークンとして送信します。デフォルトではサーバーは https://gitlab.com/api/v4 と通信します。セルフマネージドインスタンスを使用する場合は、GITLAB_API_URL にその URL を設定してください。project_id は常に文字列です。数値のプロジェクト ID と URL エンコードされたプロジェクトパスのどちらも使用できます。

インストール

npx @reneturcios/repocollab search_repositories --search my-project
docker run -i -e GITLAB_PERSONAL_ACCESS_TOKEN ghcr.io/cloudcorprecords/repocollab

CLI

repocollab search_repositories --search my-project
repocollab create_repository --name demo --visibility private
repocollab get_file_contents --project-id group/demo --file-path README.md --ref main
repocollab create_issue --project-id 42 --title "Bug report" --labels bug
repocollab list_merge_requests --project-id 42 --state opened
repocollab --version

終了コード：0 は成功、1 は API エラー、2 は使用方法のエラーです。

MCP サーバー

npx -y @reneturcios/repocollab mcp

{
  "mcpServers": {
    "repocollab": {
      "command": "npx",
      "args": ["-y", "@reneturcios/repocollab", "mcp"],
      "env": { "GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-..." }
    }
  }
}

ツール

ツール	必須	任意
search_repositories	search	—
create_repository	name	description、visibility
fork_repository	project_id	namespace
create_branch	project_id、branch	ref
get_file_contents	project_id、file_path	ref
create_or_update_file	project_id、file_path、content、commit_message、branch	previous_path
create_issue	project_id、title	description、labels
list_issues	project_id	state、per_page、page
get_issue	project_id、issue_iid	—
create_merge_request	project_id、title、source_branch、target_branch	description
list_merge_requests	project_id	state、per_page、page
get_merge_request	project_id、merge_request_iid	—

create_or_update_file は、対象ブランチにファイルがすでに存在するかを確認し、存在しない場合は作成（POST）、存在する場合は更新（PUT）します。トークンが設定されていない場合は、GITLAB_PERSONAL_ACCESS_TOKEN を示すツールエラーが返されます。上流からの HTTP エラーには、ステータスと GitLab のメッセージが含まれます。

このサブセットの対象外：パイプラインと CI、Wiki、スニペット、マイルストーン、ラベル／エピックの管理、ユーザーとグループの管理、保護ブランチ、リポジトリツリー／アーカイブ／比較の詳細、マージリクエストの承認、get_merge_request で取得できる範囲を超えるディスカッションやノート、プロジェクト以外の検索。

開発

npm install
npm run build
npm test
npm run dev

テストはすべて fake-fetch のフィクスチャを使用して実行され、ネットワークは使用しません。

ライセンス

MIT — LICENSE を参照してください。