AI导哈

知识库查询工具

一个提供Google Home API知识库下载和查询功能的MCP服务器工具，适用于AI客户端的智能查询需求。

  • by timhuang1018
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 timhuang1018/google-home-mcp-p1

使用说明

谷歌家庭MCP服务器

模型上下文协议（MCP）服务器，提供下载和查询Google Home API知识库的工具。

特性

  • 下载工具：从GitHub下载Google Home API知识库
  • 查询工具：为AI客户端提供知识库内容，以进行智能查询
  • 类型安全：使用TypeScript和Zod验证构建
  • 错误处理：向MCP客户端返回全面的错误消息

安装

来自npm（推荐）

npm install -g google-home-mcp-server

来源（开发）

git clone https://github.com/timhuang1018/google-home-mcp-p1.git
cd google-home-mcp-p1
npm install
npm run build

更新中

对于npx用户（推荐）

使用 google-home-mcp-server@latest 每次服务器启动时，都会自动获取最新版本。

面向全球安装用户

npm update -g google-home-mcp-server

发展

npm run dev

可用工具

1.下载_谷歌_主页_知识

从GitHub下载Google Home API知识库文件并将其保存在本地。

参数：无

示例:

Tool: download_google_home_knowledge

2.查询_谷歌_主页_api

查询Google Home API知识库。返回知识库的文件路径，以便AI可以根据需要使用读取工具访问相关内容。这种令牌高效的方法允许AI根据需要选择性地读取部分。

参数:

  • query_text （必需）：您关于Google Home API的问题

示例:

Tool: query_google_home_api
Arguments: { "query_text": "How do I authenticate with Google Home API?" }

备注：必须首先使用下载知识库文件 download_google_home_knowledge.

与MCP客户端一起使用

克劳德代码

添加到您的 ~/.config/claude-code/claude_code_config.json:

{
  "mcpServers": {
    "google-home": {
      "command": "npx",
      "args": ["-y", "google-home-mcp-server@latest"]
    }
  }
}

Gemini CLI

添加到MCP配置中：

{
  "mcpServers": {
    "google-home": {
      "command": "npx",
      "args": ["-y", "google-home-mcp-server@latest"]
    }
  }
}

替代方案：全球安装

如果您使用全局安装 npm install -g google-home-mcp-server:

{
  "mcpServers": {
    "google-home": {
      "command": "google-home-mcp-server"
    }
  }
}

重要:

  • 添加 mcp/ 给你的 .gitignore 在您的工作区中，从版本控制中排除下载的知识库。
  • 使用 @latest 确保您在MCP服务器启动时始终获得最新版本。

开发模式（来源）

从源头上促进当地发展：

{
  "mcpServers": {
    "google-home": {
      "command": "npx",
      "args": ["-y", "tsx", "/absolute/path/to/google-home-mcp-p1/src/index.ts"]
    }
  }
}

MCP检验员测试

npx @modelcontextprotocol/inspector npx -y google-home-mcp-server@latest

这将打开一个web界面，您可以在其中：

  • 查看可用工具
  • 带有参数的测试工具调用
  • 检查请求/响应有效载荷
  • 调试错误消息

项目结构

google-home-mcp-p1/
├── src/
│   ├── index.ts              # Main server entry point
│   ├── handlers/
│   │   ├── index.ts          # Tool registration and routing
│   │   ├── download.ts       # Download tool handler
│   │   └── query.ts          # Query tool handler
│   ├── schemas/
│   │   └── tools.ts          # Zod validation schemas
│   └── config/
│       └── constants.ts      # Configuration constants
├── build/                    # Compiled JavaScript (gitignored)
├── mcp/                      # Downloaded knowledge base (gitignored)
│   └── google-home/
│       └── google-home-api-knowledge-base.txt
├── doc/
│   └── google-home-mcp-feature.md
├── package.json
├── tsconfig.json
└── README.md

建筑

  • 运输：stdio（标准输入/输出）
  • 协议：使用JSON-RPC 2.0的MCP（模型上下文协议）
  • 软件开发工具包：官方 @modelcontextprotocol/sdk v1.0.4
  • 验证：用于类型安全参数验证的Zod模式
  • 错误处理：应用程序级错误(isError: true)返回给客户

错误处理

所有错误都会返回给MCP客户端，并附带描述性消息：

  • 下载过程中出现网络故障
  • 找不到文件错误
  • 无效参数
  • 权限错误

AI客户端（Claude Code、Gemini CLI等）可以看到这些错误并适当地处理它们。

查询策略

这 query_google_home_api 该工具使用了一种令牌高效的方法，将文件路径返回到知识库，而不是完整内容。这允许AI客户端：

  • 使用“读取”工具有选择地访问相关部分
  • 尽量减少代币消耗
  • 根据需要理解上下文和语义
  • 提供准确、情境化的答案
  • 自然地处理后续问题，无需重新发送整个内容

需求

  • Node.js v18或更高版本
  • npm或纱线

脚本

  • npm run build -将TypeScript编译为JavaScript
  • npm run dev -使用tsx在开发模式下运行服务器
  • npm start -运行已编译的服务器

许可证

国际协调委员会

相关 MCP