Gemini Context MCP Server

基本能力

产品定位

Gemini Context MCP Server 是一个专注于上下文管理和缓存的 MCP 服务器，旨在优化 Gemini 模型的使用效率，特别是在需要长期维护对话状态和减少重复 API 调用的场景中。

核心功能

1. 上下文管理
2. 支持高达 2M token 的上下文窗口
3. 基于会话的对话管理
4. 智能上下文跟踪和语义搜索

5. 自动上下文清理

6. API 缓存

7. 大型提示词缓存
8. 成本优化（减少频繁使用上下文的 token 消耗）
9. TTL 管理和自动清理

适用场景

• 需要长期维护对话状态的聊天应用
• 需要频繁使用大型系统提示词的技术支持系统
• 需要优化 API 调用成本的 AI 增强开发环境
• 需要语义搜索功能的上下文管理应用

工具列表

1. 上下文管理工具
2. generate_text: 生成带上下文的文本
3. get_context: 获取当前会话的上下文
4. clear_context: 清除会话上下文
5. add_context: 添加特定上下文条目

6. search_context: 语义搜索相关上下文

7. 缓存工具

8. mcp_gemini_context_create_cache: 创建大型上下文缓存
9. mcp_gemini_context_generate_with_cache: 使用缓存上下文生成内容
10. mcp_gemini_context_list_caches: 列出所有可用缓存
11. mcp_gemini_context_update_cache_ttl: 更新缓存 TTL
12. mcp_gemini_context_delete_cache: 删除缓存

常见问题解答

• 如何获取 Gemini API 密钥？ 从 Google AI 开发者网站 获取
• 如何配置不同的客户端？ 参考 MCP Client Configuration Guide
• 如何自定义服务器配置？ 通过修改 .env 文件中的环境变量

使用教程

使用依赖

• Node.js 18+
• Gemini API 密钥

# 安装 Node.js (推荐使用 nvm)
nvm install 18
nvm use 18

安装教程

# 克隆仓库
git clone https://github.com/ogoldberg/gemini-context-mcp-server
cd gemini-context-mcp

# 安装依赖
npm install

# 复制环境变量示例
cp .env.example .env

# 在 .env 文件中添加您的 Gemini API 密钥
# GEMINI_API_KEY=your_api_key_here

调试方式

# 构建服务器
npm run build

# 启动服务器
node dist/mcp-server.js

# 测试基本上下文管理
node test-gemini-context.js

# 测试缓存功能
node test-gemini-api-cache.js

许可证

该项目遵循 MIT 开源许可条款。