Gemini With Web Search

🚀 MCP 雙子星協議服務器（MCP Gemini）使用說明

MCP 雙子星協議服務器是基於 Node.js 開發的中間件，藉助標準 JSON - RPC 協議接口，為用戶提供 Gemini AI 服務，涵蓋文本生成、圖像處理、視頻分析和網絡搜索等功能。

🚀 快速開始

MCP 雙子星協議服務器是用於提供 Gemini AI 服務的中間件。若你想快速體驗其功能，可按以下步驟操作：

環境要求

• Node.js 版本 18.0.0 或以上
• npm 或 yarn 包管理工具
• 公共雲服務賬號（可選）

安裝步驟

# 克隆代碼倉庫
git clone https://github.com/techkwon/mcp-gemini.git

# 進入項目目錄
cd mcp-gemini

# 安裝依賴包
npm install

# 配置環境變量
export GOOGLE_API_KEY=your_api_key_here

# 啟動服務
npm run start

✨ 主要特性

文本生成功能

• 支持多輪對話，讓交流更連貫。
• 提供上下文記憶，確保對話邏輯一致。
• 支持多語言，滿足不同用戶需求。

圖像編輯能力

• 基於強大的 Gemini 2.0 模型。
• 支持圖像生成與編輯，釋放創意。
• 提供多種視覺效果，讓圖像更出彩。

視頻分析功能

• 可解析 YouTube 網絡視頻。
• 能自動提取內容摘要，節省時間。
• 精準識別定位關鍵幀。

網絡搜索

• 即時檢索網絡信息。
• 智能篩選結果，提供精準信息。
• 支持多語言搜索，覆蓋全球信息。

📦 安裝指南

環境要求

• Node.js 版本 18.0.0 或以上
• npm 或 yarn 包管理工具
• 公共雲服務賬號（可選）

安裝步驟

# 克隆代碼倉庫
git clone https://github.com/techkwon/mcp-gemini.git

# 進入項目目錄
cd mcp-gemini

# 安裝依賴包
npm install

# 配置環境變量
export GOOGLE_API_KEY=your_api_key_here

# 啟動服務
npm run start

功能配置

API 接口設置

• 默認監聽地址：localhost
• 監聽端口：8000
• CORS 白名單：可配置，支持多個域名

日誌管理

• 使用 pino 實現結構化日誌記錄。
• 開發環境支持 pino - pretty 模塊，提供更友好的日誌展示。

📚 詳細文檔

版本記錄

v1.0.0 (2024 - 03 - 15)

• 初始版本發佈。
• 提供基礎功能：文本生成、圖像處理、視頻分析。

v2.0.0 (2024 - 05 - 20)

• 引入 Gemini 2.0 模型。
• 新增 Web 搜索能力。
• 優化 API 接口。

使用條款

• 僅限於非商業用途，未經允許不得用於盈利目的。
• 修改後的版本必須標註修改聲明。
• 原文鏈接必須保持可見。

安全注意事項

1. API 密鑰必須通過環境變量方式傳遞。
2. 生產環境下建議啟用 HTTPS。
3. 禁止在代碼中直接嵌入密鑰信息。
4. 建議設置訪問速率限制。
5. 定期更新安全證書。

故障排除

端口衝突問題

如果出現 8000 端口被佔用的情況：

# 查找並終止相關進程
sudo lsof -i :8000

# 或者使用 pstree 命令查看具體進程
pstree -p | grep node

服務穩定性維護

• 建議使用 PM2 等專業工具進行進程管理。
• 定期檢查系統日誌，分析服務器運行狀態。
• 及時處理內存洩漏和性能退化問題。

開發指南

日誌系統

• 使用 pino 進行結構化日誌記錄。
• 支持多種日誌輸出格式，默認為 JSON 格式。

配置管理

• 環境變量優先級高於配置文件。
• 提供默認配置模板，可根據需求自定義。

項目維護者

• 張三（負責人）
• 李四（技術顧問）

貢獻指南

歡迎社區貢獻！請先閱讀貢獻規範文檔，瞭解如何參與代碼開發和提交。

📄 許可證

MIT 許可證

版權所有 (c) 2024 星辰科技公司
本項目遵守 MIT 許可證。本項目遵循 MIT 開源協議，所有貢獻都將在 MIT 協議下管理。