Gemini Context MCP 서버

Gemini의 컨텍스트 관리 및 캐싱 기능을 활용하는 강력한 MCP(Model Context Protocol) 서버 구현입니다. 이 서버는 Gemini의 2M 토큰 컨텍스트 윈도우의 가치를 극대화하는 동시에 대규모 컨텍스트의 효율적인 캐싱을 위한 도구를 제공합니다.

🚀 특징

컨텍스트 관리

최대 2M 토큰 컨텍스트 창 지원 - Gemini의 광범위한 컨텍스트 기능 활용
세션 기반 대화 - 여러 상호 작용에서 대화 상태 유지
스마트 컨텍스트 추적 - 메타데이터를 사용하여 컨텍스트 추가, 검색 및 검색
의미 검색 - 의미 유사성을 사용하여 관련 컨텍스트 찾기
자동 컨텍스트 정리 - 세션 및 컨텍스트가 자동으로 만료됩니다.

API 캐싱

대용량 프롬프트 캐싱 - 대용량 시스템 프롬프트 및 지침을 효율적으로 재사용
비용 최적화 - 자주 사용되는 컨텍스트에 대한 토큰 사용 비용 절감
TTL 관리 - 캐시 만료 시간 제어
자동 정리 - 만료된 캐시는 자동으로 제거됩니다.

🏁 빠른 시작

필수 조건

Node.js 18+ 설치됨
Gemini API 키( 여기서 받으세요 )

설치

지엑스피1

기본 사용법

# Build the server
npm run build

# Start the server
node dist/mcp-server.js

MCP 클라이언트 통합

이 MCP 서버는 다양한 MCP 호환 클라이언트와 통합될 수 있습니다.

Claude Desktop - Claude 설정에서 MCP 서버로 추가
커서 - 커서의 AI/MCP 설정에서 구성
VS Code - MCP 호환 확장 프로그램과 함께 사용

각 클라이언트와의 자세한 통합 지침은 MCP 설명서의 MCP 클라이언트 구성 가이드를 참조하세요.

빠른 클라이언트 설정

간소화된 클라이언트 설치 명령을 사용하세요.

# Install and configure for Claude Desktop
npm run install:claude

# Install and configure for Cursor
npm run install:cursor

# Install and configure for VS Code
npm run install:vscode

각 명령은 적절한 구성 파일을 설정하고 통합을 완료하기 위한 지침을 제공합니다.

💻 사용 예시

초보자를 위한

서버를 직접 사용하는 경우:

서버를 시작합니다:
node dist/mcp-server.js
제공된 테스트 스크립트를 사용하여 상호 작용하세요.
# Test basic context management node test-gemini-context.js # Test caching features node test-gemini-api-cache.js

Node.js 애플리케이션에서 사용:

import { GeminiContextServer } from './src/gemini-context-server.js';

async function main() {
  // Create server instance
  const server = new GeminiContextServer();
  
  // Generate a response in a session
  const sessionId = "user-123";
  const response = await server.processMessage(sessionId, "What is machine learning?");
  console.log("Response:", response);
  
  // Ask a follow-up in the same session (maintains context)
  const followUp = await server.processMessage(sessionId, "What are popular algorithms?");
  console.log("Follow-up:", followUp);
}

main();

전문 사용자를 위한

사용자 정의 구성 사용:

// Custom configuration
const config = {
  gemini: {
    apiKey: process.env.GEMINI_API_KEY,
    model: 'gemini-2.0-pro',
    temperature: 0.2,
    maxOutputTokens: 1024,
  },
  server: {
    sessionTimeoutMinutes: 30,
    maxTokensPerSession: 1000000
  }
};

const server = new GeminiContextServer(config);

비용 최적화를 위한 캐싱 시스템 사용:

// Create a cache for large system instructions
const cacheName = await server.createCache(
  'Technical Support System',
  'You are a technical support assistant for a software company...',
  7200 // 2 hour TTL
);

// Generate content using the cache
const response = await server.generateWithCache(
  cacheName,
  'How do I reset my password?'
);

// Clean up when done
await server.deleteCache(cacheName);

🔌 MCP 도구(커서 등)와 함께 사용

이 서버는 MCP(모델 컨텍스트 프로토콜)를 구현하여 커서나 기타 AI 기반 개발 환경과 같은 도구와 호환됩니다.

사용 가능한 MCP 도구

컨텍스트 관리 도구:
- 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 - 캐시 TTL 업데이트
- mcp_gemini_context_delete_cache - 캐시 삭제

커서로 연결하기

Cursor 와 함께 사용하면 MCP 구성을 통해 연결할 수 있습니다.

{
  "name": "gemini-context",
  "version": "1.0.0",
  "description": "Gemini context management and caching MCP server",
  "entrypoint": "dist/mcp-server.js",
  "capabilities": {
    "tools": true
  },
  "manifestPath": "mcp-manifest.json",
  "documentation": "README-MCP.md"
}

MCP 도구에 대한 자세한 사용 지침은 README-MCP.md를 참조하세요.

⚙️ 구성 옵션

환경 변수

다음 옵션을 사용하여 .env 파일을 만듭니다.

# Required
GEMINI_API_KEY=your_api_key_here
GEMINI_MODEL=gemini-2.0-flash

# Optional - Model Settings
GEMINI_TEMPERATURE=0.7
GEMINI_TOP_K=40
GEMINI_TOP_P=0.9
GEMINI_MAX_OUTPUT_TOKENS=2097152

# Optional - Server Settings
MAX_SESSIONS=50
SESSION_TIMEOUT_MINUTES=120
MAX_MESSAGE_LENGTH=1000000
MAX_TOKENS_PER_SESSION=2097152
DEBUG=false

🧪 개발

# Build TypeScript files
npm run build

# Run in development mode with auto-reload
npm run dev

# Run tests
npm test

📚 추가 자료

MCP 관련 사용법은 README-MCP.md를 참조하세요.
사용 가능한 도구를 이해하려면 mcp-manifest.json 의 매니페스트를 탐색하세요.
사용 패턴을 알아보려면 저장소의 예제 스크립트를 확인하세요.

📋 향후 개선 사항

컨텍스트 및 캐시에 대한 데이터베이스 지속성
캐시 크기 관리 및 제거 정책
벡터 기반 의미 검색
분석 및 메트릭 추적
벡터 저장소와의 통합
컨텍스트 관리를 위한 일괄 작업
하이브리드 캐싱 전략
자동 프롬프트 최적화

📄 라이센스

MIT

Gemini Context MCP Server

Integrations