Ogoldberg Gemini Context MCP Server

🚀 双子星上下文MCP服务器

双子星上下文MCP服务器是一个功能强大的MCP（模型上下文协议）服务器实现，它借助双子星的强大功能，实现了高效的上下文管理与缓存。该服务器充分挖掘了双子星2M令牌上下文窗口的潜力，还提供了大上下文的高效缓存工具。

🚀 快速开始

本服务器能让你充分利用双子星的上下文管理与缓存功能。以下是快速上手所需的步骤：

先决条件

• 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许可证。