Google MCP

🚀 Google MCP 服務器

Google MCP 服務器是一個全面的模型上下文協議（MCP）服務器，它通過統一的 API 提供對谷歌多項服務的訪問，這些服務涵蓋地圖、金融、航班、Gmail 以及日曆。

✨ 主要特性

🗺️ 谷歌地圖與地點服務

• 地理編碼：實現地址與座標之間的相互轉換。
• 地點搜索：查找企業、地標以及名勝古蹟。
• 路線規劃：獲取兩地之間的逐嚮導航路線。
• 距離矩陣：計算多個地點之間的旅行時間和距離。
• 地點詳情：獲取特定地點的詳細信息。

📈 谷歌金融服務

• 股票搜索：搜索股票、指數、共同基金、貨幣以及期貨。
• 市場數據：獲取當前價格、走勢以及市場信息。
• 財經新聞：訪問與證券相關的頂級財經新聞。

✈️ 谷歌航班服務

• 機場搜索：查找航班和機場信息。
• 航班定價：獲取航班價格和相關見解。
• 多城市行程：支持複雜的多目的地旅行。

📧 Gmail 服務

• 發送郵件：發送包含主題、正文、抄送和密送的郵件。
• 讀取郵件：使用 Gmail 查詢語法列出和搜索郵件。
• 郵件詳情：通過郵件 ID 獲取完整的郵件內容。
• 標籤管理：訪問 Gmail 標籤和組織架構。

📅 谷歌日曆服務

• 事件管理：創建、讀取、更新和刪除日曆事件。
• 多日曆支持：支持多個日曆（個人、工作、旅行）。
• 事件列表：根據過濾器和日期範圍列出事件。
• 日曆管理：列出和訪問不同的日曆。

📦 安裝指南

前提條件

• Node.js 18+
• pnpm（推薦）或 npm

安裝步驟

1. 克隆倉庫：

   git clone <repository-url>
   cd google-mcp
   

2. 安裝依賴：

   pnpm install
   

3. 構建項目：

   pnpm run build
   

MCP 客戶端集成

將服務器安裝到你首選的 MCP 客戶端：

# 安裝到所有 MCP 客戶端
pnpm run install-server

# 安裝到特定客戶端
pnpm run install-desktop    # Claude Desktop
pnpm run install-cursor     # Cursor IDE
pnpm run install-code       # Claude Code
pnpm run install-mcp        # 僅本地 .mcp.json

📚 詳細文檔

配置

環境變量

在項目根目錄下創建一個 .env.local 文件，並填入你的谷歌 API 憑證：

GOOGLE_MAPS_API_KEY=your_google_maps_api_key
GOOGLE_CLIENT_ID=your_oauth_client_id
GOOGLE_CLIENT_SECRET=your_oauth_client_secret
GOOGLE_REFRESH_TOKEN=your_refresh_token

谷歌 API 設置

1. 谷歌地圖 API：在谷歌雲控制檯中啟用地圖、地點和路線規劃 API。
2. Gmail/日曆：設置 OAuth 2.0 憑證並獲取刷新令牌。
3. 金融/航班：使用谷歌的公共 API（無需額外設置）。

使用方法

運行服務器

# 啟動編譯後的服務器
pnpm start

# 或者在開發模式下運行
node dist/index.js

可用工具

地圖與地點服務

• geocode - 將地址轉換為座標
• reverse-geocode - 將座標轉換為地址
• places-search - 通過文本查詢搜索地點
• get-directions - 獲取兩地之間的路線
• distance-matrix - 計算多個地點之間的距離
• place-details - 獲取特定地點的詳細信息

金融服務

• finance-search - 搜索股票、貨幣和金融工具

航班服務

• airports-search - 搜索航班和機場信息

Gmail 服務

• gmail-send-email - 發送郵件
• gmail-read-emails - 列出/搜索郵件
• gmail-get-email - 通過 ID 獲取特定郵件
• gmail-get-labels - 列出 Gmail 標籤

日曆服務

• calendar-create-event - 創建新事件
• calendar-list-events - 根據過濾器列出事件
• calendar-get-event - 獲取特定事件的詳細信息
• calendar-update-event - 更新現有事件
• calendar-delete-event - 刪除事件
• calendar-list-calendars - 列出可用的日曆

🔧 技術細節

項目結構

src/
├── index.ts       # 主 MCP 服務器實現
├── maps.ts        # 谷歌地圖與地點功能
├── finance.ts     # 谷歌金融集成
├── airports.ts    # 谷歌航班集成  
├── gmail.ts       # Gmail API 集成
└── calendar.ts    # 谷歌日曆集成

scripts/
└── update-config.js   # MCP 客戶端配置安裝程序

dist/             # 編譯後的 JavaScript 輸出

關鍵技術

• MCP SDK：使用 @modelcontextprotocol/sdk 實現協議。
• 模式驗證：使用 Zod 進行運行時類型檢查。
• 谷歌 API：使用官方谷歌客戶端庫。
• TypeScript：以 ES2022 為目標，實現完全的類型安全。
• 傳輸層：使用 StdioServerTransport 進行 MCP 通信。

開發工作流

1. 在 src/ 目錄下的 TypeScript 文件中進行修改。
2. 構建項目：pnpm run build
3. 測試：pnpm start
4. 安裝到客戶端：pnpm run install-server
5. 重啟 MCP 客戶端以加載更改。

添加新工具

1. 為參數定義 Zod 模式。
2. 實現處理函數。
3. 使用 server.tool() 在 src/index.ts 中註冊工具。
4. 構建並重新安裝以進行測試。

架構設計

此 MCP 服務器遵循以下設計模式：

• 模塊化設計：每個谷歌服務都位於其自己的模塊中。
• 模式驗證：所有參數都使用 Zod 模式進行驗證。
• 錯誤處理：全面的錯誤處理，提供有意義的錯誤消息。
• 類型安全：完全使用 TypeScript 覆蓋，並啟用嚴格模式。
• 傳輸無關性：使用 MCP 的標準傳輸層。

📄 許可證

[License information]

貢獻說明

[Contribution guidelines]