google-knowledge-graph

Google Knowledge Graph Search MCP

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

クイックナビゲーション

このツールを作った理由 | できること | インストール | APIキーの取得 | 使用例 | パラメーター | エンティティタイプ | トラブルシューティング

これは何ですか？ MCP サーバーです。これが何を意味するのか分からない場合は、おそらく必要ありません。Claude Desktopやその他のMCP対応クライアントを使っていて、Googleのナレッジデータベースを検索したい方に役立ちます。

このツールを作った理由

調査ワークフロー中にClaudeがエンティティ情報を確認できる方法が必要だったため、これを作りました。Google Knowledge Graphには、何百万もの現実世界のエンティティに関する構造化データが含まれています。Google検索結果に表示されるナレッジパネルを支えているのと同じデータです。

Knowledge Graph Search APIは完全に無料です。課金アカウントも利用料金も不要で、Google Cloud APIキーだけで使えます。このように便利なものが存在することを、ほとんどの開発者が知らないようなのは不思議です。

このMCPを使うと、Claude（または任意のMCPクライアント）がそのデータベースにアクセスできます。

できること

Google Knowledge Graphを検索する2つのツールを提供します。

1. クエリで検索 - search_knowledge_graph 名前や説明でエンティティを検索します。エンティティタイプ、説明、WikipediaのURL、関連度スコアなどの構造化データを返します。

2. MIDで検索 - lookup_knowledge_graph_entities
Machine ID（Google内部のエンティティ識別子）をすでに持っている場合、それを直接検索できます。エンティティ解決ワークフローに便利です。

どちらも次の情報を含むJSONを返します。

• エンティティ名とタイプ
• 詳細な説明（通常はWikipediaから取得）
• 公式画像とURL
• 結果スコア（関連度の順位）
• 追加検索に使えるMachine ID

インストール

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"
      }
    }
  }
}

Claude Code（CLI）

Claude Codeでは異なる登録方法を使います。claude_desktop_config.jsonは読み込まれません。代わりにclaude mcp addを使います。

claude mcp add \
  -e GOOGLE_KNOWLEDGE_GRAPH_API_KEY=your-api-key-here \
  -s user \
  google-knowledge-graph -- npx -y @houtini/google-knowledge-graph-mcp

次のコマンドで確認します。

claude mcp get google-knowledge-graph

Status: Connectedと表示されます。

ローカルインストール

ソースから実行する場合は、次の手順を行ってください。

git clone https://github.com/houtini-ai/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 ユーザー： パスにはバックスラッシュを 2 つ使用してください：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. 「認証情報」に移動し、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（MID）の配列。例：["/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 を再起動します

結果が返されない場合：

• 検索語を変えてみます
• エンティティタイプのフィルターを削除して検索範囲を広げます
• 結果の上限が低すぎないか確認します

400「API key not valid」エラー：

• API キーが無効、期限切れ、または種類が異なります（Google AI Studio の「AQ.」キーは使用できません。Google Cloud の「AIza...」キーが必要です）
• 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 のパターンを使用しています。互換性のため、こちらも CommonJS を採用しています。独自の MCP を構築して ES modules を使いたい場合は、それでも問題ありません。選択が異なるだけです。

貢献

問題を見つけた場合や改善案がある場合は、次の手順に従ってください。

1. まず既存の問題を確認します
2. 変更をローカルでテストします
3. 説明を明確に記載して PR を提出します

特に、次のような点についてご意見をお待ちしています。

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

ライセンス

MIT - ご自由にお使いください。

作成者

AI を活用した開発および調査ワークフロー向け MCP サーバーのコレクションの一環として、Richard Baxter（Houtini）が作成しました。

その他の 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 クライアント

---

ステータス： 本番環境で利用可能。Claude Desktop でテスト済み