Ogoldberg Gemini Context MCP Server

🚀 雙子星上下文MCP服務器

雙子星上下文MCP服務器是一個功能強大的MCP（模型上下文協議）服務器實現。它充分利用雙子星的功能，實現了高效的上下文管理與緩存，最大程度發揮了雙子星2M令牌上下文窗口的價值，還提供了緩存大上下文的有效工具。

🚀 快速開始

雙子星上下文MCP服務器藉助雙子星的強大能力，實現了高效的上下文管理和緩存功能。在使用前，請確保滿足以下先決條件，並按照安裝步驟完成服務器的部署。

先決條件

• Node.js（推薦使用版本14或更高）
• npm（推薦使用版本6或更高）
• 一個雙子星 API密鑰

安裝步驟

1. 克隆項目倉庫：

git clone [倉庫地址]
cd gemini-context-mcp-server

2. 安裝依賴項：

npm install

3. 配置環境變量，創建一個.env文件：

GEMINI_API_KEY=你的_api_密鑰

4. 啟動服務器：

node index.js

✨ 主要特性

上下文管理

• 支持高達2M令牌的上下文窗口：充分利用雙子星的上下文能力。
• 生成文本：帶有上下文的文本生成。
• 獲取上下文：獲取特定會話的當前上下文。
• 清除上下文：清除某個會話的上下文。
• 添加上下文：添加具體的上下文條目。
• 搜索上下文：半基於內容的上下文搜索。

緩存管理

• 創建緩存：用於存儲大塊上下文信息。
• 生成帶緩存：使用緩存中的上下文進行文本生成。
• 列出緩存：查看所有可用的緩存。
• 更新緩存 TTL：調整緩存的有效期。
• 刪除緩存：刪除不再需要的緩存。

📚 詳細文檔

核心功能

• 上下文管理：處理多個會話的上下文信息，支持添加、查詢和刪除操作。
• 緩存機制：提供高效的上下文存儲解決方案，優化重複請求的性能。
• 自動過期：緩存條目會根據設定的時間戳自動失效，確保數據新鮮度。

高級特性

• 上下文搜索：通過內容相似性查找相關上下文，提升信息檢索效率。
• 速率限制：控制請求頻率，防止服務過載。
• 日誌記錄：記錄操作日誌，便於調試和監控。

💻 使用示例

客戶端集成

命令行工具

# 創建一個新的上下文條目
mcp create-context --session-id 12345 --content "歡迎來到雙子星上下文管理"

# 加載現有上下文
mcp load-context --session-id 12345

# 清除特定會話的上下文
mcp clear-context --session-id 12345

緩存操作示例

# 創建一個新的緩存條目
mcp create-cache --cache-id user-logs --content "/var/log/app"

# 使用緩存生成文本
mcp generate-with-cache --cache-id user-logs --prompt "解釋日誌文件的內容"

# 更新緩存的TTL
mcp update-cache-ttl --cache-id user-logs --ttl 3600

# 刪除緩存條目
mcp delete-cache --cache-id user-logs

配置選項

創建一個.env文件，包含以下選項：

GEMINI_API_KEY=你的_api_密鑰
GEMINI_MODEL=g4（可選，默認為g4）
API_RATE_LIMIT=100（可選，默認為無限制）
CONTEXT_EXPIRATION_MINUTES=60（可選，默認為60分鐘）

進一步閱讀

• 瞭解詳細的MCP協議規範，請參考文檔
• 探索更多集成示例和高級用法，請訪問官方文檔

🔧 技術細節

未來改進方向

• 引入數據庫持久化，使上下文和緩存信息不因重啟而丟失。
• 實現智能緩存策略，如LRU替換算法，提升緩存效率。
• 集成向量數據庫，增強上下文的語義搜索能力。

📄 許可證

本項目採用MIT許可證。