谷歌知识图谱搜索MCP
模型上下文协议服务器，将Claude（或任何MCP客户端）连接到Google的免费公共知识图API。搜索真实世界的实体——人、地方、组织、概念——并获取结构化数据。
快速导航 为什么存在 | 你得到了什么 | 安装 | 获取API密钥 | 用法示例 | 参数 | 实体类型 | 故障排除
这是什么？ MCP服务器。如果你不知道这意味着什么，你可能不需要这个。如果你使用的是Claude Desktop或其他兼容MCP的客户端，并想搜索谷歌的知识数据库，这是为你准备的。
为什么存在
我构建这个是因为我需要一种方法让克劳德在研究工作流程中验证实体信息。谷歌的知识图谱包含数百万个现实世界实体的结构化数据，这些数据为谷歌搜索结果中的知识面板提供了动力。
知识图谱搜索API是完全免费的。没有账单账户，没有使用费用，只有一个谷歌云API密钥。大多数开发人员似乎不知道这是存在的，考虑到它有多有用，这很奇怪。
此MCP允许Claude（或任何MCP客户端）访问该数据库。
所得
搜索谷歌知识图谱的两个工具：
1.按查询搜索 - search_knowledge_graph 按名称或描述搜索实体。返回结构化数据，包括实体类型、描述、维基百科网址和相关性得分。
2.MID查询 - lookup_knowledge_graph_entities\ 如果你已经有机器ID（谷歌的内部实体标识符），直接查找它们。适用于实体解析工作流。
两者都返回JSON：
- 实体名称和类型
- 详细描述（通常来自维基百科）
- 官方图片和网址
- 结果得分（相关性排名）
- 用于进一步查找的机器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"
}
}
}
}克劳德代码（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/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\\...
配置位置：
- 窗户：
%APPDATA%\Claude\claude_desktop_config.json - macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json
获取API密钥
谷歌的知识图谱搜索API是免费的。真正免费-无需计费帐户。
- 首选 谷歌云控制台
- 创建新项目（或选择现有项目）
- 在API库中启用“知识图搜索API”
- 导航到“凭据”并创建API密钥
- （可选但建议使用）将密钥仅限于知识图搜索API
就是这样。没有信用卡，没有账单设置。
使用示例
安装完毕并重新启动Claude Desktop后，您可以：
基本实体搜索：
Search the knowledge graph for "Marie Curie"实体类型筛选：
Search knowledge graph for "Python" with types ["ComputerLanguage"]多个结果：
Search knowledge graph for "Paris" limit 5MID查找：
Look up knowledge graph entity /m/0dl567MCP返回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
}参数
搜索知识图
- 查询 （必填）：搜索词
- 语言 （可选）：语言代码数组，例如。
["en"] - 类型 （可选）：要筛选的实体类型，例如。
["Person", "Organization"] - 限制 （可选）：最大结果（默认20，最大500）
查找知识图形实体
- 标识符 （必填）：机器ID（MID）数组，例如。
["/m/0dl567"] - 语言 （可选）：语言代码数组
常见实体类型
知识图谱使用schema.org类型。常见的：
Person-个人Organization-公司、机构Place-地点、地理实体Event-历史或当前事件CreativeWork-书籍、电影、音乐、艺术Product-商业产品ComputerLanguage-编程语言SportsTeam-运动队Country-国家和民族City-城市和市政当局
您可以组合类型以进行更具体的搜索。
故障排除
MCP未出现在Claude中：
- 检查JSON语法-一个错误会破坏一切
- 验证路径是否使用了正确的转义(
\\在Windows上） - 完全重新启动Claude Desktop（退出，而不仅仅是最小化）
- 检查API密钥环境变量拼写
“需要API密钥”错误：
- 未读取环境变量
- 检查拼写：
GOOGLE_KNOWLEDGE_GRAPH_API_KEY - 配置更改后重新启动Claude Desktop
未返回任何结果：
- 尝试不同的查询词
- 删除实体类型筛选器以扩大搜索范围
- 检查结果限制没有设置得太低
401未经授权：
- API密钥无效或已过期
- 知识图谱搜索API未在您的Google Cloud项目中启用
从源头构建
npm install
npm run build构建过程将TypeScript编译为CommonJS dist/无需特殊配置。
技术细节
- API终结点：
https://kgsearch.googleapis.com/v1/entities:search - 响应格式： JSON-LD
itemListElement数组 - 身份验证： API键通过查询参数
- 费率限制： 免费等级配额适用（通常为100000次查询/天）
- 模块格式： CommonJS（与Node.js MCP主机兼容）
为什么选择CommonJS？
MCP SDK使用CommonJS模式。为了兼容性，我一直坚持这样做。如果你正在构建自己的MCP并想要ES模块，那很好——只是选择不同。
贡献
如果您发现问题或有改进：
- 先检查现有问题
- 在本地测试您的更改
- 提交一份描述清晰的PR
我特别感兴趣的是：
- 需要更好处理的实体类型
- 响应解析边缘情况
- 真实世界的使用模式
许可证
麻省理工学院-随心所欲。
作者
理查德·巴克斯特建造(胡蒂尼)作为用于人工智能辅助开发和研究工作流程的MCP服务器集合的一部分。
其他Houtini MCP：
@houtini/gemini-mcp-谷歌人工智能聊天与基础和深入研究@houtini/geo-analyzer-AI搜索引擎的内容优化@houtini/brevo-mcp-电子邮件营销自动化
相关
______________________________________________________________________
版本： 1.0.0\ 状态： 生产就绪，用Claude Desktop测试