快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

Claude Gemini MCP与上下文管理

先进的MCP（模型上下文协议）服务器，可实现Claude和Gemini之间的无缝协作 智能持久上下文管理.

✨ 主要特点

🤖 人工智能协作

多轮对话 克劳德和双子座之间
共识检测 确定协议领域
智能合成 不同的AI视角
直接Gemini查询 针对具体问题

🧠 持久上下文管理

会话连续性 -对话记得以前的讨论
智能上下文注入 -自动包含相关历史记录
显式上下文API -开发人员完全控制记住的内容
主动召回建议 -基于过去互动的主动建议

🔒 安全与隐私

AES-256加密 对于所有存储的上下文数据
自动敏感数据屏蔽 （API密钥、PII、凭据等）
基于会话的访问控制 带UUID验证
可配置的数据保留 以及到期政策
仅限本地存储 -无外部依赖关系

🎛️ 开发人员控制

6个上下文管理工具 用于细粒度控制
灵活配置 通过环境变量
基于标签的组织 用于上下文分类
相关性评分 用于智能上下文检索

快速开始

1.安装

git clone 
cd claude-gemini-mcp
npm install

2.配置

cp .env.example .env
# Add your Gemini API key and optional settings

3.构建和启动

npm run build
npm start

4.克劳德代码集成

从项目根目录运行此命令：

claude mcp add --scope user claude-gemini node $(pwd)/dist/index.js

环境配置

# Required: Get your API key from https://aistudio.google.com/app/apikey
GEMINI_API_KEY=your_gemini_api_key_here

# Optional: Model selection (default: gemini-2.5-flash)
GEMINI_MODEL=gemini-2.5-flash

# Context Management Settings
CONTEXT_DB_PATH=./data/context.db                    # Database location
CONTEXT_ENCRYPTION_KEY=your_64_char_hex_key         # Encryption key
CONTEXT_MAX_ENTRIES=1000                            # Max entries per session
CONTEXT_DEFAULT_EXPIRY_DAYS=30                      # Default expiry
ENABLE_CONTEXT_LOGGING=true                         # Operation logging

可用工具

核心合作

`collaborate`

通过持续的上下文增强协作对话。

await collaborate({
  prompt: "How should we optimize this API endpoint?",
  claudeResponse: "I suggest implementing caching...",
  sessionId: "optional-existing-session",           // For continuity
  useContext: true,                                 // Enable context (default)
  contextTags: ["api", "optimization", "caching"]  // Filter relevant context
});

`query_gemini`

直接向Gemini询问具体问题。

await query_gemini({
  prompt: "What are the latest best practices for React state management?"
});

上下文管理

`create_session`

为有组织的对话创建新的上下文会话。

const session = await create_session({
  userId: "developer-123",
  projectId: "mobile-app-redesign"
});

`add_to_context`

存储重要信息以备将来参考。

await add_to_context({
  sessionId: session.sessionId,
  data: {
    decision: "Use Redux Toolkit for state management",
    rationale: "Better DevTools and reduced boilerplate",
    alternatives: ["Zustand", "Valtio", "React Context"]
  },
  tags: ["decision", "state-management", "redux"],
  key: "state-management-decision"
});

`get_context_summary`

获取会话上下文的概述。

const summary = await get_context_summary({
  sessionId: session.sessionId
});
// Returns: totalEntries, recentEntries, tags, summary, tokenCount

`get_relevant_context`

检索特定的上下文条目。

const relevantContext = await get_relevant_context({
  sessionId: session.sessionId,
  tags: ["api", "performance"],
  limit: 5
});

`clear_context`

通过灵活的范围界定清理上下文数据。

await clear_context({
  sessionId: session.sessionId,
  scope: "expired"  // "session", "expired", or "all"
});

`tag_context`

将元数据标签添加到现有上下文条目中。

await tag_context({
  sessionId: session.sessionId,
  entryId: "context-entry-id",
  tags: ["reviewed", "approved", "production-ready"]
});

使用模式

基于项目的工作流

// 1. Start a project session
const session = await create_session({
  projectId: "ecommerce-checkout-redesign"
});

// 2. Add project requirements
await add_to_context({
  sessionId: session.sessionId,
  data: {
    requirements: ["Mobile-first design", "One-click checkout", "Guest checkout"],
    constraints: ["PCI compliance", "Existing payment gateway", "2-second load time"]
  },
  tags: ["requirements", "constraints", "project-start"]
});

// 3. Collaborate with context awareness
const designResult = await collaborate({
  prompt: "Design the new checkout flow",
  claudeResponse: "Based on the requirements for mobile-first design...",
  sessionId: session.sessionId,
  contextTags: ["requirements", "design"]
});

// 4. Continue iterating with full context
const implementationResult = await collaborate({
  prompt: "How do we implement the one-click checkout?",
  claudeResponse: "Building on our design discussion...",
  sessionId: session.sessionId  // Previous context automatically included
});

研究和决策

// Research session with context accumulation
const researchSession = await create_session({
  projectId: "database-migration-research"
});

// Accumulate research findings
await add_to_context({
  sessionId: researchSession.sessionId,
  data: {
    database: "PostgreSQL",
    pros: ["ACID compliance", "JSON support", "Strong ecosystem"],
    cons: ["Learning curve", "Resource usage"],
    benchmarks: { reads: "15k qps", writes: "8k qps" }
  },
  tags: ["research", "postgresql", "benchmarks"]
});

// Make informed decisions with full research context
const decision = await collaborate({
  prompt: "Should we migrate from MySQL to PostgreSQL?",
  claudeResponse: "Let me analyze this migration decision...",
  sessionId: researchSession.sessionId,
  contextTags: ["research", "decision", "migration"]
});

发展

脚本

npm run dev      # Development mode with auto-reload
npm run build    # Build TypeScript to JavaScript
npm run start    # Start production server
npm run clean    # Clean build directory
npm run rebuild  # Clean and rebuild

项目结构

src/
├── context/           # Context management system
│   ├── storage.ts     # SQLite + encryption layer
│   ├── manager.ts     # High-level context operations
│   └── security.ts    # Data masking and security
├── tools/             # MCP tools
│   ├── conversation.ts    # Enhanced collaboration tool
│   ├── context-tools.ts   # Context management APIs
│   └── gemini-query.ts    # Direct Gemini queries
├── gemini/            # Gemini client
│   └── client.ts      # API wrapper
├── types.ts           # TypeScript interfaces
├── server.ts          # MCP server implementation
└── index.ts           # Entry point

安全功能

自动数据保护

系统自动检测并屏蔽敏感信息：

API密钥和令牌（任何类似 api_key=...)
JWT代币
GitHub代币（ghp\_，gho）
Google API密钥（AIza…）
AWS访问密钥（AKIA…）
电子邮件地址
信用卡号码
电话号码
网际协议地址
数据库连接字符串

访问控制

会话隔离：每个会话都有自己的加密上下文
UUID验证：只接受有效的会话ID
可配置的到期时间：自动清理旧上下文数据
审核日志记录：跟踪所有上下文操作（可配置）

隐私设计

仅限本地存储：没有外部服务或云依赖关系
静态加密：所有使用AES-256加密的上下文数据
选择存储：可以完全禁用上下文
安全摘要：上下文摘要不会泄露敏感细节

建筑

上下文存储

SQLite Database (AES-256 Encrypted)
├── Sessions Table
│   ├── Session metadata and lifecycle
│   └── Encrypted summaries
├── Context Entries Table
│   ├── Encrypted data with relevance scoring
│   ├── Tag-based categorization
│   └── Configurable expiry timestamps
└── Indexes for performance
    ├── Session-based lookups
    ├── Time-based queries
    └── Relevance scoring

安全管道

Input Data → Sensitive Data Detection → Encryption → Storage
                     ↓
            [REDACTED] markers replace sensitive content

上下文管理流程

User Input → Context Retrieval → Enhanced Prompt → AI Collaboration → Context Storage
     ↑                                                                        ↓
     └─── Active Recall Suggestions ←─── Analysis ←─── Results Storage ←─────┘

故障排除

常见问题

“需要GEMINI_API_KEY环境变量”

从获取API密钥谷歌人工智能工作室
将其添加到您的 .env 文件： GEMINI_API_KEY=your_key_here

“加密/解密数据失败”

为生成一个64个字符的十六进制字符串 CONTEXT_ENCRYPTION_KEY
用途： node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"
如果没有此密钥，数据将不会在服务器重新启动时持续存在

会话之间上下文不起作用

验证 data 目录存在并且可写
检查是否一致使用相同的加密密钥
确保数据库文件路径可访问

性能问题

减少 CONTEXT_MAX_ENTRIES （默认值：1000）
缩短设置 CONTEXT_DEFAULT_EXPIRY_DAYS （默认值：30）
使用 clear_context 随着 scope: "expired" 定期

内存使用量大

为了提高性能，上下文数据被缓存在内存中
使用更短的到期时间进行开发
考虑为长时间运行的会话定期重启服务器

路线图

✅ 当前版本（v2.0.0）

✅ 具有加密功能的持久上下文管理
✅ 通过上下文感知增强人工智能协作
✅ 全面的安全和隐私措施
✅ 通过显式API实现完全的开发人员控制

🚧 第二阶段：人工智能驱动的环境（计划中）

🔄 智能上下文摘要
🔄 具有成本意识的上下文管理
🔄 高级相关性算法
🔄 上下文衰减和新鲜度评分

📋 第3阶段：高级功能（未来）

📅 分层上下文组织
📅 跨会话上下文链接
📅 协作多用户环境
📅 高级协作模式
📅 自定义上下文处理器插件系统

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

支持

📚 文档：查看此README和内联代码注释
🐛 问题: 用于错误和功能请求
💬 讨论: 问题和想法

______________________________________________________________________

Claude Gemini MCP v2.0 - *具有持久记忆的智能AI协作。* 🤖🧠✨

目录标签

AI协作安全TypeScriptClaude持久化存储本地部署上下文管理安全加密开发者工具

支持客户端

Claude

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

api-key

工具数量（toolCount，工具数）

8

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明api-key部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/8655d29100e4a1318b60f9f83cfa6729

一个先进的MCP服务器，实现Claude和Gemini之间的无缝协作，并提供智能持久化上下文管理功能。

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

Claude For Desktop MCP

通过MCP协议连接Claude for Desktop实现智能文件管理的解决方案，适用于需要自动化文件操作的个人和开发者。

下一个 MCP

Claude Godot MCP

一个基于Model Context Protocol的Godot编辑器集成工具，提供170多种开发工具，通过Claude AI实现从提示到完整游戏的全自动开发流程。