Google Knowledge Graph MCP

🚀 Google Knowledge Graph Search MCP

このプロジェクトは、Claude（または任意のMCPクライアント）をGoogleの無料公開Knowledge Graph APIに接続するModel Context Protocolサーバーです。人、場所、組織、概念などの現実世界のエンティティを検索し、構造化データを取得できます。

🚀 クイックスタート

このMCPサーバーは、Claude Desktopやその他のMCP互換クライアントを使用してGoogleの知識データベースを検索するために使用できます。もしMCPが何かわからない場合は、このサーバーは必要ないかもしれません。

✨ 主な機能

• GoogleのKnowledge Graph APIを利用して、現実世界のエンティティを検索し、構造化データを取得できます。
• クエリによる検索と、Machine ID（MID）による検索の2つの方法があります。
• 返されるJSONデータには、エンティティの名前、タイプ、説明、画像、URL、関連性スコアなどが含まれます。

📦 インストール

NPX（最も簡単）

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "google-knowledge-graph": {
      "command": "npx",
      "args": ["-y", "@houtini/google-knowledge-graph-mcp"],
      "env": {
        "GOOGLE_KNOWLEDGE_GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

ローカルインストール

ソースから実行する場合は、以下の手順を実行します。

git clone https://github.com/houtini/google-knowledge-graph-mcp.git
cd google-knowledge-graph-mcp
npm install
npm run build

その後、Claude Desktopを以下のように設定します。

{
  "mcpServers": {
    "google-knowledge-graph": {
      "command": "node",
      "args": ["C:\\path\\to\\google-knowledge-graph-mcp\\dist\\index.js"],
      "env": {
        "GOOGLE_KNOWLEDGE_GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windowsユーザー: パスにはダブルバックスラッシュを使用してください: C:\\MCP\\...

設定ファイルの場所:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

APIキーの取得

GoogleのKnowledge Graph Search APIは無料です。請求アカウントは必要ありません。

1. Google Cloud Consoleにアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. APIライブラリで"Knowledge Graph Search API"を有効にします。
4. "Credentials"に移動し、APIキーを作成します。
5. （オプションだが推奨）キーをKnowledge Graph Search APIのみに制限します。

以上です。クレジットカードや請求設定は必要ありません。

💻 使用例

インストールし、Claude Desktopを再起動すると、以下のような操作ができます。

基本的なエンティティ検索

Search the knowledge graph for "Marie Curie"

エンティティタイプのフィルタリング

Search knowledge graph for "Python" with types ["ComputerLanguage"]

複数の結果を取得

Search knowledge graph for "Paris" limit 5

MIDによる検索

Look up knowledge graph entity /m/0dl567

MCPはClaudeが解析できる構造化JSONを返します。エンティティの名前、タイプ、説明、URL、関連性スコアが含まれます。

返されるデータの例

{
  "entities": [
    {
      "mid": "/m/0dl567",
      "name": "Taylor Swift",
      "type": ["Person", "Thing"],
      "description": "American singer-songwriter",
      "detailedDescription": "Taylor Alison Swift is an American singer-songwriter...",
      "image": "https://...",
      "url": "http://en.wikipedia.org/wiki/Taylor_Swift",
      "resultScore": 4258.07
    }
  ],
  "count": 1
}

📚 詳細ドキュメント

パラメータ

search_knowledge_graph

• query (必須): 検索用語
• languages (オプション): 言語コードの配列、例: ["en"]
• types (オプション): フィルタリングするエンティティタイプ、例: ["Person", "Organization"]
• limit (オプション): 最大結果数（デフォルト20、最大500）

lookup_knowledge_graph_entities

• ids (必須): Machine ID（MIDs）の配列、例: ["/m/0dl567"]
• languages (オプション): 言語コードの配列

一般的なエンティティタイプ

Knowledge Graphはschema.orgのタイプを使用しています。一般的なものは以下の通りです。

• Person - 個人
• Organization - 企業、機関
• Place - 場所、地理的エンティティ
• Event - 歴史的または現在のイベント
• CreativeWork - 書籍、映画、音楽、芸術
• Product - 商業製品
• ComputerLanguage - プログラミング言語
• SportsTeam - スポーツチーム
• Country - 国
• City - 都市、自治体

より具体的な検索のために、タイプを組み合わせることができます。

トラブルシューティング

MCPがClaudeに表示されない場合

1. JSON構文を確認してください - 1つのエラーですべてが壊れます。
2. パスが正しくエスケープされていることを確認してください（Windowsでは\\）。
3. Claude Desktopを完全に再起動してください（最小化ではなく終了してから再起動）。
4. APIキーの環境変数のスペルを確認してください。

"API key required"エラーが発生する場合

• 環境変数が読み取られていない可能性があります。
• スペルを確認してください: GOOGLE_KNOWLEDGE_GRAPH_API_KEY
• 設定を変更した後、Claude Desktopを再起動してください。

結果が返されない場合

• 異なるクエリ用語を試してみてください。
• エンティティタイプのフィルターを削除して、検索を広げてみてください。
• 結果の制限が低く設定されていないことを確認してください。

401 Unauthorizedエラーが発生する場合

• APIキーが無効または期限切れです。
• Google CloudプロジェクトでKnowledge Graph Search APIが有効になっていない可能性があります。

ソースからビルドする方法

npm install
npm run build

ビルドプロセスでは、TypeScriptがdist/にCommonJS形式でコンパイルされます。特別な設定は必要ありません。

🔧 技術詳細

• APIエンドポイント: https://kgsearch.googleapis.com/v1/entities:search
• レスポンス形式: itemListElement配列を含むJSON-LD
• 認証: クエリパラメータを介したAPIキー
• レート制限: 無料枠のクォータが適用されます（一般的に1日100,000クエリ）
• モジュール形式: CommonJS（Node.js MCPホストと互換性があります）

なぜCommonJSを使用しているのか

MCP SDKはCommonJSパターンを使用しています。互換性のためにこの形式を採用しています。独自のMCPを構築してESモジュールを使用したい場合は、別の選択肢です。

🤝 コントリビュート

問題を見つけたり、改善点がある場合は、以下の手順でPRを送ってください。

1. まず既存のissueを確認してください。
2. 変更をローカルでテストしてください。
3. 明確な説明付きでPRを提出してください。

特に興味があるのは以下の点です。

• より適切に処理する必要があるエンティティタイプ
• レスポンス解析のエッジケース
• 実際の使用パターン

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。自由に使用してください。

👨‍💻 作者

このプロジェクトはRichard Baxter (Houtini)によって構築され、AI支援開発および研究ワークフロー用のMCPサーバーのコレクションの一部として提供されています。

その他のHoutini MCP:

• @houtini/gemini-mcp - Google AIチャットのグラウンディングと深い調査
• @houtini/geo-analyzer - AI検索エンジン用のコンテンツ最適化
• @houtini/brevo-mcp - メールマーケティング自動化

🔗 関連リンク

• Model Context Protocol - プロトコル仕様
• Google Knowledge Graph API - 公式APIドキュメント
• Claude Desktop - 主要なMCPクライアント

バージョン: 1.0.0
ステータス: 本番環境で使用可能、Claude Desktopでテスト済み