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上进行测试