HippoDid MCP Server

HippoDid용 MCP(Model Context Protocol) 서버 — Claude Code, Claude Desktop, ChatGPT, Gemini CLI, Codex CLI, Cursor 및 모든 MCP 호환 클라이언트를 영구적인 AI 캐릭터 메모리에 연결합니다.

HippoDid란 무엇인가요?

HippoDid는 AI 에이전트를 위한 클라우드 메모리 인프라입니다. 선호도, 결정, 기술, 관계와 같은 구조화된 메모리를 검색 가능한 데이터베이스에 저장하고 세션, 도구, AI 공급자 전반에 걸쳐 검색합니다. Claude Code에서 메모리를 작성하고 ChatGPT에서 회상하세요. Cursor에서 Gemini로 전환해도 에이전트의 메모리는 함께 이동합니다.

주요 기능:

• 크로스 플랫폼 메모리 — OAuth를 통해 모든 MCP 클라이언트 또는 ChatGPT에서 동일한 메모리에 접근

• 구조화 추출 — 원시 텍스트가 중요도 점수와 함께 분류된 사실로 자동 파싱

• 시간적 감쇠 — 메모리는 카테고리별로 자연스럽게 희미해짐 (기술은 영구적, 이벤트는 14일 후 소멸)

• 캐릭터 범위 지정 — 각 에이전트/프로젝트는 자체 메모리 네임스페이스를 가짐

• BYOK AI — 추출을 위해 자체 OpenAI, Anthropic 또는 Gemini 키 사용

Related MCP server: memory-mcp

빠른 시작

1. API 키 받기

hippodid.com에 가입하고 대시보드에서 API 키를 생성하세요.

2. JAR 다운로드

GitHub 릴리스에서 최신 릴리스를 다운로드하세요.

3. Claude Desktop 구성

Claude Desktop 구성 파일(~/Library/Application Support/Claude/claude_desktop_config.json, macOS)에 추가하세요:

{
  "mcpServers": {
    "hippodid": {
      "command": "java",
      "args": ["-jar", "/path/to/hippodid-mcp-server-1.1.0.jar"],
      "env": {
        "HIPPODID_API_KEY": "hd_key_your_key_here",
        "HIPPODID_CHARACTER_ID": "your-character-uuid"
      }
    }
  }
}

4. 사용 시작

Claude에게 무언가를 기억하도록 요청하고, 메모리를 검색하고, 파일을 동기화하는 등의 작업을 수행하세요.

MCP 도구

환경 변수

아키텍처

Claude Desktop → stdio (JSON-RPC) → McpServerRunner → HippoDidClient → HTTP → HippoDid REST API

MCP 서버는 hippodid-spring-boot-starter를 사용하여 HTTP를 통해 HippoDid REST API와 통신합니다. 모든 인증과 테넌트 격리는 Bearer 토큰을 통해 서버 측에서 처리됩니다.

소스에서 빌드

Java 21+ 및 Maven 3.8+가 필요합니다.

mvn clean package -DskipTests
java -jar target/hippodid-mcp-server-1.1.0.jar

버전 관리

MCP 서버 버전은 hippodid-spring-boot-starter 버전과 일치합니다. 호환성을 위해 두 버전이 동일해야 합니다.

라이선스

Apache License 2.0 — LICENSE 참조.