Weather Ai Agent

🚀 谷歌雙子星API與MCP工具集成項目說明

本項目展示瞭如何將谷歌雙子星API與自定義工具相結合，這些自定義工具由多雲平臺（MCP）框架進行管理。項目利用雙子星API處理自然語言查詢，並藉助MCP工具依據查詢意圖執行特定操作，為自然語言處理與工具執行的結合提供了有效解決方案。

🚀 快速開始

✨ 主要特性

• 實現谷歌雙子星API與MCP工具的集成。
• 利用雙子星API處理自然語言查詢。
• 通過MCP工具根據查詢意圖執行特定操作。

📦 安裝指南

在運行此項目之前，需要滿足以下先決條件：

• Python 3.7或更高版本
• 啟用了谷歌雲項目的雙子星API並獲取了API密鑰
• 設置好了MCP環境並安裝了必要的工具
• 在項目根目錄下創建.env文件，並添加以下環境變量：

GEMINI_API_KEY=<你的雙子星API密鑰>
GEMINI_MODEL=<你的雙子星模型名稱>
MCP_RUNNER=<mcp運行器路徑>
MCP_SCRIPT=<mcp腳本路徑>

安裝步驟如下：

1. 克隆倉庫：

git clone <倉庫URL>
cd <倉庫目錄>

2. 創建虛擬環境（推薦）：

python3 -m venv venv
source venv/bin/activate  # 在macOS/Linux上

3. 使用uv安裝所需的依賴項：

uv pip install dotenv google-generativeai mcp
uv add "mcp[cli]" httpx
uv pip install python-dotenv google-generativeai mcp

4. 創建項目根目錄下的.env文件，並添加你的環境變量。

GEMINI_API_KEY=你的API密鑰
GEMINI_MODEL=gemini-pro
MCP_RUNNER=mcp運行器路徑
MCP_SCRIPT=mcp腳本路徑

💻 使用示例

基礎用法

運行應用程序，請執行以下命令：

python main.py

🔧 技術細節

工作原理

1. 應用程序加載並驗證環境變量的存在性。
2. 與MCP客戶端建立連接。
3. 獲取MCP會話中的可用工具。
4. 將提示發送到雙子星API，並附帶工具定義。
5. 處理模型調用的任何工具。
6. 返回最終響應，包含工具調用的結果。

自定義指南

要自定義提示或行為：

1. 修改prompt變量以設置所需的文本。
2. 調整get_contents()函數以更改提示格式。
3. 擴展process_response()函數以處理不同類型的響應。