基本能力
产品定位
Gemini Context MCP Server 是一个专注于上下文管理和 API 缓存的 MCP 服务器,旨在优化大型语言模型的使用体验,特别是在需要长期维护对话状态和减少重复计算成本的场景中。
核心功能
- 上下文管理
- 支持高达 2M token 的上下文窗口
- 基于会话的对话管理
- 智能上下文跟踪和语义搜索
-
自动上下文清理
-
API 缓存
- 大型提示词缓存
- 成本优化机制
- TTL 管理和自动清理
适用场景
- 需要长期维护对话状态的聊天应用
- 频繁使用大型系统提示词的应用
- 需要优化 API 调用成本的开发项目
- 与 MCP 兼容客户端(如 Claude Desktop、Cursor、VS Code)集成的开发环境
工具列表
- 上下文管理工具
generate_text
: 带上下文的文本生成get_context
: 获取会话上下文clear_context
: 清除会话上下文add_context
: 添加上下文条目-
search_context
: 语义搜索相关上下文 -
缓存工具
mcp_gemini_context_create_cache
: 创建大型上下文缓存mcp_gemini_context_generate_with_cache
: 使用缓存生成内容mcp_gemini_context_list_caches
: 列出所有缓存mcp_gemini_context_update_cache_ttl
: 更新缓存 TTLmcp_gemini_context_delete_cache
: 删除缓存
常见问题解答
- 需要 Node.js 18+ 和 Gemini API 密钥
- 配置通过 .env 文件完成
- 支持多种 MCP 兼容客户端集成
使用教程
使用依赖
- 安装 Node.js 18+
- 获取 Gemini API 密钥 (https://ai.google.dev/)
安装教程
```bash
克隆仓库
git clone https://github.com/ogoldberg/gemini-context-mcp-server
cd gemini-context-mcp-server
安装依赖
npm install
复制环境变量示例
cp .env.example .env
在 .env 文件中添加 Gemini API 密钥
GEMINI_API_KEY=your_api_key_here
```
调试方式
```bash
构建服务器
npm run build
启动服务器
node dist/mcp-server.js
测试基本上下文管理
node test-gemini-context.js
测试缓存功能
node test-gemini-api-cache.js
```