Google Knowledge Graph MCP

🚀 Google Knowledge Graph Search MCP

Google Knowledge Graph Search MCP是一個Model Context Protocol（MCP）服務器，它能將Claude（或任何MCP客戶端）連接到Google免費的公共知識圖譜API。藉助該工具，你可以搜索現實世界中的實體，如人物、地點、組織、概念等，並獲取結構化數據。

🚀 快速開始

如果你正在使用Claude Desktop或其他支持MCP的客戶端，並且希望搜索Google的知識數據庫，那麼這個項目正適合你。

✨ 主要特性

• 提供兩種搜索Google知識圖譜的工具：
  • 按查詢搜索：search_knowledge_graph，可按名稱或描述搜索實體，返回包含實體類型、描述、維基百科URL和相關性分數的結構化數據。
  • 按MID查找：lookup_knowledge_graph_entities，如果你已經有機器ID（Google的內部實體標識符），可以直接進行查找，適用於實體解析工作流程。
• 兩種工具返回的JSON數據包含實體名稱和類型、詳細描述（通常來自維基百科）、官方圖片和URL、結果分數（相關性排名）以及用於進一步查找的機器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"
      }
    }
  }
}

本地安裝

如果你更喜歡從源代碼運行：

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的知識圖譜搜索API是免費的，無需計費賬戶。

1. 訪問Google Cloud Console。
2. 創建一個新項目（或選擇現有項目）。
3. 在API庫中啟用“Knowledge Graph Search API”。
4. 導航到“Credentials”並創建一個API密鑰。
5. （可選但推薦）將密鑰限制為僅用於知識圖譜搜索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

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（必需）：機器ID（MIDs）數組，例如["/m/0dl567"]
• languages（可選）：語言代碼數組

常見實體類型

知識圖譜使用schema.org類型，常見的類型包括：

• Person：個人
• Organization：公司、機構
• Place：地點、地理實體
• Event：歷史或當前事件
• CreativeWork：書籍、電影、音樂、藝術
• Product：商業產品
• ComputerLanguage：編程語言
• SportsTeam：體育團隊
• Country：國家
• City：城市和直轄市

你可以組合使用這些類型進行更具體的搜索。

🔧 技術細節

• API端點：https://kgsearch.googleapis.com/v1/entities:search
• 響應格式：帶有itemListElement數組的JSON-LD
• 身份驗證：通過查詢參數使用API密鑰
• 速率限制：適用免費層配額（通常為每天100,000次查詢）
• 模塊格式：CommonJS（與Node.js MCP主機兼容）

🔧 故障排除

MCP未在Claude中顯示

1. 檢查JSON語法，一個錯誤可能會導致整個配置失效。
2. 驗證路徑是否使用了正確的轉義字符（Windows上使用\\）。
3. 完全重啟Claude Desktop（退出而不僅僅是最小化）。
4. 檢查API密鑰環境變量的拼寫。

出現“API key required”錯誤

• 環境變量未被讀取。
• 檢查拼寫：GOOGLE_KNOWLEDGE_GRAPH_API_KEY。
• 配置更改後重啟Claude Desktop。

沒有返回結果

• 嘗試不同的查詢詞。
• 移除實體類型過濾器以擴大搜索範圍。
• 檢查結果限制是否設置得過低。

401 Unauthorized錯誤

• API密鑰無效或已過期。
• Google Cloud項目中未啟用知識圖譜搜索API。

🔧 從源代碼構建

npm install
npm run build

構建過程會將TypeScript編譯為CommonJS，存儲在dist/目錄中，無需特殊配置。

🔧 為什麼使用CommonJS？

MCP SDK使用CommonJS模式，為了保持兼容性，本項目也採用了這種模式。如果你正在構建自己的MCP並希望使用ES模塊，那也是可以的，只是選擇不同而已。

🤝 貢獻

如果你發現問題或有改進建議：

1. 首先檢查現有問題。
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上進行測試