Gemini API文档搜索服务

Gemini Docs MCP服务器

一个远程HTTP MCP服务器，提供搜索和检索Google Gemini API文档的工具。服务器在以下位置公开MCP协议 /mcp 端点，可以部署到Cloud Run或其他容器化平台。它还支持本地stdio模式进行开发。

• 搜索文档：在所有Gemini文档页面上进行全文搜索。
• 获取能力：列出可用的文档页面或检索特定页面的内容。
• 获取当前模型：快速访问当前Gemini型号的文档。
• 自动更新：在服务器启动时复制和更新文档。

sequenceDiagram
    participant Client as MCP Client / IDE
    participant Server as FastMCP Server
    participant DB as SQLite Database

    Client->>Server: call_tool("search_documentation", queries=["embeddings"])
    Server->>DB: Full-Text Search for "embeddings"
    DB-->>Server: Return matching documentation
    Server-->>Client: Return formatted results

它是如何工作的

1. 摄入：启动时，服务器获取 https://ai.google.dev/gemini-api/docs/llms.txt 获取所有可用文档页面的列表。
2. 处理：然后，它同时获取和处理每个页面，提取文本内容。
3. 索引：处理后的内容存储在具有全文搜索（FTS5）索引的本地SQLite数据库中，以实现高效查询。
4. 搜索：当您使用 search_documentation 工具，服务器查询此SQLite数据库以查找最相关的文档页面。

安装

选项1：使用 uvx （推荐）

您可以使用 uvx 直接运行服务器，无需显式安装。这是最简单的开始方式。

uvx --from git+https://github.com/philschmid/gemini-api-docs-mcp gemini-docs-mcp

选项2：直接从GitHub安装

您可以使用以下命令直接从GitHub安装该软件包 pip:

pip install git+https://github.com/philschmid/gemini-api-docs-mcp.git

选项3：手动安装（用于开发）

git clone https://github.com/philschmid/gemini-api-docs-mcp.git
cd gemini-api-docs-mcp
pip install -e .
cd ..
rm -rf gemini-api-docs-mcp

用法

作为远程HTTP服务器运行

服务器作为HTTP服务器运行，并在 /mcp 终点。它尊重 PORT 环境变量（默认为8080）。

# Set port (optional, defaults to 8080)
export PORT=8080

# Run the server
gemini-docs-mcp

服务器将可在以下位置访问 http://localhost:8080/mcp （或您配置的端口）。

Docker部署

构建并运行Docker容器：

# Build the image
docker build -t gemini-docs-mcp .

# Run the container
docker run -p 8080:8080 gemini-docs-mcp

云运行部署

部署到Google Cloud Run：

# Build and deploy
gcloud run deploy gemini-docs-mcp \
  --source . \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated

服务器将可在以下位置访问 https://<your-service-url>/mcp.

在标准模式（本地）下运行

如果你不设置 PORT 环境变量，服务器在本地MCP客户端的stdio模式下运行：

# Don't set PORT - runs in stdio mode
gemini-docs-mcp

配置

数据库存储在：

• /tmp/gemini-api-docs/database.db 在容器化环境中
• ~/.mcp/gemini-api-docs/database.db 在当地环境中

您可以通过设置 GEMINI_DOCS_DB_PATH 环境变量。

与MCP客户端一起使用

对于远程HTTP服务器，请将MCP客户端配置为通过HTTP连接：

{
  "mcpServers": {
    "gemini-docs": {
      "url": "https://<your-service-url>/mcp"
    }
  }
}

对于使用stdio的本地开发（如果您的客户端支持）：

{
  "mcpServers": {
    "gemini-docs": {
      "command": "gemini-docs-mcp"
    }
  }
}

工具

• search_documentation(queries: list[str])：对Gemini文档执行给定查询列表的全文搜索（最多3个）。
• get_capability_page(capability: str = None)：获取特定功能或内容的列表。
• get_current_model()：获取当前Gemini型号的文档。

许可证

麻省理工学院

测试结果

我们运行了一个全面的评估工具，以确保MCP服务器提供准确和最新的代码示例。测试涵盖了Python和TypeScript SDK。

最后更新时间：2025-11-03 13:29:01

您可以在以下网址找到详细的测试结果 tests/result.json.