Aliargun MCP Server Gemini

🚀 通用 Gemini MCP 服務器

這是一個實現 Google Gemini AI 模型與 Claude Desktop 交互的 Model Context Protocol (MCP) 服務器，能有效促進兩者之間的通信協作，為用戶帶來更便捷的使用體驗。

🚀 快速開始

1. 獲取 Gemini API 密鑰
   • 訪問 Google AI 工作室。
   • 創建一個新的 API 密鑰。
2. 配置 Claude Desktop
   • 找到你的配置文件：

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

- 添加 Gemini 配置：

{
    "mcpServers": {
        "gemini": {
            "command": "npx",
            "args": ["-y", "github:aliargun/mcp-server-gemini"],
            "env": {
                "GEMINI_API_KEY": "你的 API 密鑰"
            }
        }
    }
}

3. 重啟 Claude Desktop

✨ 主要特性

• 完全支持 MCP 協議。
• 即時響應流式傳輸。
• 安全的 API 密鑰處理。
• 可配置的模型參數。
• TypeScript 實現。

📚 詳細文檔

• Claude Desktop 安裝指南 - 詳細的安裝說明。
• 示例和使用方法 - 使用示例及高級配置。
• 實現細節 - 技術實現詳情。
• 開發指南 - 開發人員指南。
• 故障排除指南 - 常見問題解決方案。

💻 使用示例

本地開發

# 克隆倉庫
git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini

# 安裝依賴
npm install

# 啟動開發服務器
npm run dev

🤝 貢獻

歡迎貢獻！請參考我們的 Contributing Guide。

❓ 常見問題

1. 連接問題
   • 檢查端口 3005 是否可用。
   • 驗證網絡連接。
   • 參考 故障排除指南。
2. API 密鑰問題
   • 確認 API 密鑰是否正確。
   • 檢查權限設置。
   • 參考 安裝指南。

🔒 安全

• 僅通過環境變量處理 API 密鑰。
• 不存儲或記錄任何敏感數據。
• 定期更新安全補丁。

📄 許可證

MIT