Gemini Api Docs MCP

🚀 Gemini Docs MCP Server

Gemini Docs MCP Server 是一個本地標準輸入輸出（STDIO）的 MCP 服務器，它提供了搜索和檢索 Google Gemini API 文檔的工具。藉助該服務器，用戶能夠高效地查找所需的文檔內容，提升開發效率。

🚀 快速開始

Gemini Docs MCP Server 為開發者提供了便捷的途徑來搜索和獲取 Google Gemini API 文檔。它具備全文搜索、獲取文檔能力列表、查看當前模型文檔等功能，並且會在服務器啟動時自動更新文檔。

✨ 主要特性

• 搜索文檔：可對所有 Gemini 文檔頁面進行全文搜索。
• 獲取能力信息：列出可用的文檔頁面，或檢索特定頁面的內容。
• 獲取當前模型：快速訪問當前 Gemini 模型的文檔。
• 自動更新：在服務器啟動時抓取並更新文檔。

📦 安裝指南

選項 1：使用 uvx（推薦）

你可以使用 uvx 直接運行服務器，無需顯式安裝。這是最簡單的啟動方式。

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

選項 2：直接從 GitHub 安裝

你可以使用 pip 直接從 GitHub 安裝該軟件包。

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

💻 使用示例

基礎用法

如果你通過 pip 安裝（選項 2 或 3），可以使用以下命令運行服務器：

gemini-docs-mcp

這將通過標準輸入輸出啟動 MCP 服務器。服務器會立即開始攝取文檔，首次運行時可能需要一些時間。

高級用法

配置

數據庫默認存儲在 ~/.mcp/gemini-api-docs/database.db。你可以通過設置 GEMINI_DOCS_DB_PATH 環境變量來覆蓋此路徑。

與 MCP 客戶端配合使用

配置你的 MCP 客戶端以運行 gemini-docs-mcp 命令。

{
  "mcpServers": {
    "gemini-docs": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/philschmid/gemini-api-docs-mcp", "gemini-docs-mcp"]
    }
  }
}

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

📚 詳細文檔

工作原理

1. 攝取階段：服務器啟動時，會獲取 https://ai.google.dev/gemini-api/docs/llms.txt 以獲取所有可用文檔頁面的列表。
2. 處理階段：隨後併發地獲取並處理每個頁面，提取文本內容。
3. 索引階段：處理後的內容存儲在本地 SQLite 數據庫中，並使用全文搜索（FTS5）索引，以便高效查詢。
4. 搜索階段：當你使用 search_documentation 工具時，服務器會查詢該 SQLite 數據庫以找到最相關的文檔頁面。

工具說明

• search_documentation(queries: list[str])：對給定的查詢列表（最多 3 個）在 Gemini 文檔中進行全文搜索。
• get_capability_page(capability: str = None)：獲取能力列表或特定能力的內容。
• get_current_model()：獲取當前 Gemini 模型的文檔。

測試結果

我們運行了全面的評估工具，以確保 MCP 服務器提供準確和最新的代碼示例。測試涵蓋了 Python 和 TypeScript SDK。

最後更新時間：2025-11-03 13:29:01

你可以在 tests/result.json 中找到詳細的測試結果。

📄 許可證

本項目採用 MIT 許可證。