返回 MCP 目录
public公开dns本地运行

gemini-context-mcp-server

基于Gemini的上下文管理与缓存MCP服务器,支持2M token大上下文窗口,提供会话管理和API缓存功能。

article

README

🚀 金星上下文MCP服务器

金星上下文MCP服务器是一个功能强大的MCP(模型上下文协议)服务器实现,它借助Gemini的能力,实现了高效的上下文管理与缓存。该服务器充分发挥了Gemini 2M令牌上下文窗口的优势,同时提供了用于缓存大上下文的实用工具。

🚀 快速开始

金星上下文MCP服务器是一个功能强大的工具,借助Gemini的能力实现上下文管理和缓存。以下是快速使用该服务器的步骤:

  1. 克隆仓库:
git clone https://github.com/yourusername/gemini-context-mcp.git
cd gemini-context-mcp
  1. 安装依赖:
npm install
  1. 配置环境变量,创建.env文件:
GEMINI_API_KEY=your_api_key_here
GEMINI_MODEL=gemini-2.0-flash

# 可选 - 模型设置
GEMINI_TEMPERATURE=0.7
GEMINI_TOP_K=40
GEMINI_TOP_P=0.9
GEMINI_MAX_OUTPUT_TOKENS=2097152

# 可选 - 服务器设置
MAX_SESSIONS=50
SESSION_TIMEOUT_MINUTES=120
MAX_MESSAGE_LENGTH=1000000
MAX_TOKENS_PER_SESSION=2097152
DEBUG=false
  1. 启动服务器:
node dist/index.js

✨ 主要特性

上下文管理

  • 支持高达2M令牌上下文窗口:充分挖掘Gemini强大的上下文处理能力,为复杂对话提供广阔的上下文空间。
  • 基于会话的对话:在多次交互过程中,精准维护会话状态,确保对话的连贯性和逻辑性。
  • 智能上下文跟踪:通过使用元数据,能够灵活地添加、检索和搜索上下文,提高信息获取效率。
  • 语义相似度搜索:基于上下文内容进行语义相关性匹配,快速定位所需信息。
  • 动态上下文更新:根据对话历史自动调整上下文,使对话更加智能和自然。

API缓存

  • 大上下文缓存:为长文本生成任务提供高效的上下文存储和检索机制,提升处理性能。
  • 自适应缓存策略:依据访问频率和时间智能管理缓存,优化资源利用。
  • 缓存持久化选项:支持将重要上下文持久化到本地或远程存储,确保数据的安全性和可恢复性。
  • 批量操作支持:具备多条上下文记录的批量处理能力,提高操作效率。
  • 上下文版本控制:对不同版本的上下文进行有效管理和追溯,方便后续分析和优化。

📦 安装指南

克隆仓库

git clone https://github.com/yourusername/gemini-context-mcp.git
cd gemini-context-mcp

安装依赖

npm install

配置环境变量

创建.env文件,并按如下示例进行配置:

GEMINI_API_KEY=your_api_key_here
GEMINI_MODEL=gemini-2.0-flash

# 可选 - 模型设置
GEMINI_TEMPERATURE=0.7
GEMINI_TOP_K=40
GEMINI_TOP_P=0.9
GEMINI_MAX_OUTPUT_TOKENS=2097152

# 可选 - 服务器设置
MAX_SESSIONS=50
SESSION_TIMEOUT_MINUTES=120
MAX_MESSAGE_LENGTH=1000000
MAX_TOKENS_PER_SESSION=2097152
DEBUG=false

启动服务器

node dist/index.js

📄 许可证

本项目采用MIT许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端