Gcp MCP

🚀 GCP MCP サーバー

このサーバーは、モデルコンテキストプロトコル (MCP) を利用し、ClaudeのようなAIアシスタントがGoogle Cloud Platform (GCP) 環境と対話できるようにします。これにより、会話中に自然言語でGCPリソースを照会および管理することが可能です。

🚀 クイックスタート

このGCP MCPサーバーを使用することで、自然言語を使ってGCPリソースの照会や管理が可能になります。以下のセクションでは、サーバーのインストール、設定、使用方法について詳しく説明します。

✨ 主な機能

• 🔍 自然言語でGCPリソースを照会および変更できます。
• ☁️ 複数のGCPプロジェクトをサポートします。
• 🌐 複数のリージョンをサポートします。
• 🔐 安全な認証情報の処理（外部サービスに認証情報を公開しません）。
• 🏃♂️ ローカルで実行し、あなたのGCP認証情報を使用します。
• 🔄 信頼性向上のための自動リトライ機能。

📦 インストール

前提条件

• Node.js
• Claude Desktop/Cursor/Windsurf
• ローカルに設定されたGCP認証情報（アプリケーションのデフォルト認証情報）

インストール手順

1. リポジトリをクローンします:

git clone https://github.com/eniayomi/gcp-mcp
cd gcp-mcp

2. 依存関係をインストールします:

npm install

📚 ドキュメント

設定

Claude Desktop

1. Claudeデスクトップアプリケーションを開き、設定 -> 開発者 -> 設定の編集に移動します。
2. claude_desktop_config.json に以下の内容を追加します：

npm経由の場合:

{
  "mcpServers": {
    "gcp": {
      "command": "sh",
      "args": ["-c", "npx -y gcp-mcp"]
    }
  }
}

ソースコードからインストールした場合:

{
  "mcpServers": {
    "gcp": {
      "command": "npm",
      "args": [
        "--silent",
        "--prefix",
        "/path/to/gcp-mcp",
        "start"
      ]
    }
  }
}

/path/to/gcp-mcp を実際のプロジェクトディレクトリのパスに置き換えてください。

Cursor

1. Cursorを開き、設定 (⌘,) に移動します。
2. AI -> モデルコンテキストプロトコルに移動します。
3. 新しいMCP設定を追加します：

{
  "gcp": {
    "command": "npx -y gcp-mcp"
  }
}

Windsurf

1. ~/.windsurf/config.json を開きます（存在しない場合は作成します）。
2. 以下のMCP設定を追加します：

{
  "mcpServers": {
    "gcp": {
      "command": "npx -y gcp-mcp"
    }
  }
}

GCP設定

1. GCP認証情報を設定します：

   • gcloud auth application-default login を使用してアプリケーションのデフォルト認証情報を設定します。

2. AIアシスタント（Claude Desktop/Cursor/Windsurf）を更新します。

使用方法

このサーバーを使用すると、自然言語でGCPリソースを照会および管理できます。以下は使用例です：

• すべての利用可能なプロジェクトを照会する: すべてのGCPプロジェクトをリストアップして
• 現在のプロジェクトのIDを取得する: 現在のプロジェクトのIDを教えて

利用可能なツール

• gcp-mcp-server: MCPサーバーを起動するためのツールです。
• gcp-mcp-client: MCPサーバーと対話するためのクライアントツールです。

サンプル対話

ユーザー: すべてのGCPプロジェクトをリストアップして
システム: はい、以下はあなたが持っているすべてのGCPプロジェクトのリストです：
       1. project-12345
       2. dev-environment
       3. production-server

トラブルシューティング

問題が発生した場合は、以下のことを確認してください：

1. 必要なGCP APIが有効になっていることを確認します。
2. あなたのアカウントがリソースにアクセスするのに十分な権限を持っていることを検証します。
3. 詳細なエラー情報を取得するためにログファイルを確認します：

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log

コントリビューション

コントリビューションを歓迎します！自由にプルリクエストを送信してください。

📄 ライセンス

MITライセンスの下で提供されています。