google-knowledge-graph

Google 知识图谱搜索 MCP

Model Context Protocol 服务，可将 Claude（或任何 MCP 客户端）连接到 Google 免费的公共知识图谱 API。搜索现实世界中的实体——人物、地点、组织、概念——并获取结构化数据。

快速导航

为何开发此项目 | 你将获得什么 | 安装 | 获取 API 密钥 | 使用示例 | 参数 | 实体类型 | 故障排除

这是什么？ 一个 MCP 服务。如果你不知道这意味着什么，那你可能不需要它。如果你正在使用 Claude Desktop 或其他兼容 MCP 的客户端，并希望搜索 Google 的知识数据库，那么这就是为你准备的。

为何开发此项目

我开发这个工具，是因为在研究工作流中，我需要一种让 Claude 验证实体信息的方法。Google 知识图谱包含数百万个现实世界实体的结构化数据——这些数据也为 Google 搜索结果中的知识面板提供支持。

知识图谱搜索 API 完全免费。无需结算账户，也没有使用费用，只需一个 Google Cloud API 密钥。大多数开发者似乎不知道它的存在；考虑到它如此实用，这还挺奇怪的。

这个 MCP 服务让 Claude（或任何 MCP 客户端）能够访问该数据库。

你将获得什么

两个用于搜索 Google 知识图谱的工具：

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（命令行）

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 用户： 路径中使用双反斜杠：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 会返回结构化 JSON，供 Claude 解析。你将获得实体名称、类型、描述、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 - 城市和自治市

你可以组合多种类型，以进行更具体的搜索。

故障排除

Claude 中未显示 MCP：

1. 检查 JSON 语法——一个错误就会导致整个配置失效
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
• 响应格式： JSON-LD，包含 itemListElement 数组
• 身份验证： 通过查询参数传递 API 密钥
• 速率限制： 适用免费套餐配额（通常为每天 100,000 次查询）
• 模块格式： CommonJS（兼容 Node.js MCP 主机）

为什么使用 CommonJS？

MCP SDK 使用 CommonJS 模式。为确保兼容性，我也采用了这种方式。如果你要构建自己的 MCP 并希望使用 ES 模块，也完全没问题——只是选择不同而已。

贡献

如果你发现问题或有改进建议：

1. 请先查看现有问题
2. 在本地测试你的更改
3. 提交一份说明清晰的 PR

我尤其希望了解以下方面：

• 需要改进处理方式的实体类型
• 响应解析中的边缘情况
• 真实世界中的使用模式

许可证

MIT——随你使用。

作者

由 Richard Baxter（Houtini）构建，属于一系列用于 AI 辅助开发和研究工作流的 MCP 服务。

其他 Houtini MCP 服务：

• @houtini/gemini-mcp - 支持 grounding 和深度研究的 Google AI 聊天
• @houtini/geo-analyzer - 面向 AI 搜索引擎的内容优化
• @houtini/brevo-mcp - 电子邮件营销自动化

相关内容

• Model Context Protocol - 协议规范
• Google Knowledge Graph API - 官方 API 文档
• Claude Desktop - 主要的 MCP 客户端

---

状态： 已可用于生产环境，已通过 Claude Desktop 测试