GitLab MCP Server

GitLab MCP サーバー

GitLab サーバーとやり取りします。

これは、セルフホスト型の GitLab インスタンスとやり取りする TypeScript ベースの MCP サーバーです。このサーバーは、GitLab のデータ、具体的にはプロジェクト、イシュー、イシューノート（コメント）を取得および管理するツールを提供します。利用可能なツールは、list_projects、get_issues、get_issue_notes、search、get_issue、get_todos、get_wiki_page、list_wiki_pages です。

機能

この GitLab MCP サーバーは、次のツールを提供します。

• list_projects：ユーザーがアクセスできるすべてのプロジェクトを一覧表示します。
• get_issues：基本的なフィルタリング機能を使用して、特定のプロジェクトのイシューを取得します。
• get_issue_notes：特定のイシューのノート（コメント）を取得します。
• search：検索語に基づいてプロジェクトとイシューを検索します。
• get_issue：ID と IID を使用して、プロジェクトから特定のイシューを取得します。
• get_todos：オプションのフィルターを使用して、ToDo 項目の一覧を取得します。
• get_wiki_page：プロジェクト ID とスラッグを指定して、特定の Wiki ページを取得します。
• list_wiki_pages：指定したプロジェクトのすべての Wiki ページを取得します。

開発

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバーの設定を追加します。

{
  "mcpServers": {
    "gitlab-server": {
      "command": "/path/to/gitlab-server/build/index.js",
      "env": {
        "GITLAB_API_TOKEN": "<Gitlab API Token >",
        "GITLAB_HOST": "<GitLab Host URL>"
      }
    }
  }
}

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして利用できます。

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を提示します。

GitLab API ドキュメント

https://gitlab.com/gitlab-org/gitlab/-/tree/master/doc/api https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/rest/_index.md https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/rest/authentication.md https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/projects.md https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/issues.md https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/notes.md https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/issue_links.md https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/search.md https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/wikis.md