Gitlab Docs MCP

🚀 GitLab Docs MCP Server

Model Context Protocol サーバーで、AIアシスタントがGitLabの公式ドキュメントに即座にアクセスできるようにします。

✨ 主な機能

• インテリジェント検索 - すべてのドキュメントを高速かつ関連性順に検索します。
• セクションフィルタリング - 特定の領域（CI/CD、API、管理など）を対象に検索できます。
• 完全なコンテンツアクセス - ドキュメントの完全なページを取得できます。
• 常に最新 - GitLabの最新のドキュメントと自動的に同期されます。
• 汎用互換性 - すべてのMCP互換AIアシスタントで動作します。

📦 インストール

このサーバーは、すべてのMCP互換AIアシスタントで動作します。Model Context Protocol を使用することで、AIアシスタントは標準化されたインターフェースを介して外部ツールやデータソースに接続できます。

GitHub Copilot (VS Code)

1. MCP設定を開く ⌘+Shift+P （Windows/Linuxでは Ctrl+Shift+P）を押し、MCP: Open User Configuration と入力してEnterを押します。

2. mcp.json に追加する

{
  "servers": {
    "gitlab-docs": {
      "command": "npx",
      "args": ["-y", "gitlab-docs-mcp"]
    }
  }
}

3. VS Codeを再読み込みする ⌘+Shift+P （または Ctrl+Shift+P）を押し、Developer: Reload Window と入力してEnterを押します。

代替方法：以下の場所に手動でファイルを作成/編集することもできます。

• macOS：~/Library/Application Support/Code/User/mcp.json
• Windows：%APPDATA%\Code\User\mcp.json
• Linux：~/.config/Code/User/mcp.json

Claude Desktop

Claude Desktopは、Anthropicによるスタンドアロンのデスクトップアプリケーションで、MCPサーバーをサポートしています。

Claude Desktopの設定ファイルに追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gitlab-docs": {
      "command": "npx",
      "args": ["-y", "gitlab-docs-mcp"]
    }
  }
}

Claude Desktopを再起動します。

Cursor IDE

Cursorは、組み込みのMCPサポートを備えています。MCP設定ファイルを作成または編集します。

1. 設定ファイルを作成/編集する

• プロジェクト固有：プロジェクトルートの .cursor/mcp.json
• グローバル：ホームディレクトリの ~/.cursor/mcp.json

2. サーバー設定を追加する

{
  "servers": {
    "gitlab-docs": {
      "command": "npx",
      "args": ["-y", "gitlab-docs-mcp"]
    }
  }
}

3. Cursorを再起動する

その他のMCPクライアント

他のMCP互換クライアント（Zed、Windsurfなど）では、次のコマンドを実行するように設定します。

npx -y gitlab-docs-mcp

必要な特定の形式については、クライアントのMCP設定ドキュメントを参照してください。

💻 使用例

基本的な使用法

設定が完了したら、AIアシスタントにGitLabに関する質問をするだけです。

会話の例

あなた: "GitLabでCI/CDパイプラインを設定するにはどうすればいいですか？"
アシスタント: [GitLabのドキュメントを検索し、詳細なパイプライン構成ガイドを提供]

あなた: "UbuntuでGitLab Runnerを設定する方法を教えてください"
アシスタント: [GitLab Runnerのインストールドキュメントを取得]

あなた: "問題を更新するためのGraphQLミューテーションは何ですか？"
アシスタント: [APIドキュメントを検索し、GraphQLミューテーションの例を表示]

あなた: "GitLabの認証オプションを説明してください"
アシスタント: [認証ドキュメントから概要を提供]

AIアシスタントは自動的にGitLab Docs MCPサーバーを使用してドキュメントを検索し、正確で最新の回答を提供します。

📚 ドキュメント

searchGitLabDocs

2,494ページのGitLabドキュメントをインテリジェントなランキングで検索します。

パラメーター

• query - 検索用語
• maxResults - 最大結果数（デフォルト: 10、最大: 50）
• section - セクションでフィルタリング: ci、api、user、admin、development

getDocPage

特定のドキュメントページの完全なコンテンツを取得します。

パラメーター

• path - ドキュメントのパス（例: "ci/yaml/README.md"）

listDocSections

利用可能なドキュメントセクションとその構造を閲覧します。

🔧 トラブルシューティング

サーバーが応答しない場合

• Node.js 22以上がインストールされていることを確認します。node --version
• AIアシスタント/クライアントを完全に再起動します。
• MCP接続エラーに関するアプリケーションログを確認します。

ドキュメントが最新ではない場合 サーバーは自動的にnpmから最新の公開バージョンを使用します。MCPクライアントを再起動するだけで更新を取得できます。

🤝 コントリビューション

バグを見つけた場合や機能要求がある場合は、GitHubリポジトリ をご覧ください。

📄 ライセンス

MIT - 詳細については LICENSE ファイルを参照してください。