HippoDid MCP Server

Servidor MCP (Model Context Protocol) para HippoDid — conecta Claude Code, Claude Desktop, ChatGPT, Gemini CLI, Codex CLI, Cursor y cualquier cliente compatible con MCP a la memoria persistente de personajes de IA.

¿Qué es HippoDid?

HippoDid es una infraestructura de memoria en la nube para agentes de IA. Almacena recuerdos estructurados (preferencias, decisiones, habilidades, relaciones) en una base de datos buscable y los recupera entre sesiones, herramientas y proveedores de IA. Escribe un recuerdo en Claude Code, recupéralo en ChatGPT. Cambia de Cursor a Gemini: la memoria de tu agente viaja con él.

Características principales:

• Memoria multiplataforma — los mismos recuerdos accesibles desde cualquier cliente MCP o ChatGPT mediante OAuth

• Extracción estructurada — el texto sin procesar se analiza automáticamente en hechos categorizados con puntuaciones de relevancia

• Decaimiento temporal — los recuerdos se desvanecen naturalmente por categoría (las habilidades son permanentes, los eventos se desvanecen en 14 días)

• Alcance por personaje — cada agente/proyecto tiene su propio espacio de nombres de memoria

• BYOK AI — trae tu propia clave de OpenAI, Anthropic o Gemini para la extracción

Related MCP server: memory-mcp

Inicio rápido

1. Obtén una clave de API

Regístrate en hippodid.com y crea una clave de API desde tu panel de control.

2. Descarga el JAR

Descarga la última versión desde GitHub Releases.

3. Configura Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en 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. Empieza a usarlo

Pídele a Claude que recuerde cosas, busque recuerdos, sincronice archivos y más.

Herramientas MCP

Variables de entorno

Arquitectura

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

El servidor MCP utiliza el hippodid-spring-boot-starter para comunicarse con la API REST de HippoDid a través de HTTP. Toda la autenticación y el aislamiento de inquilinos se manejan en el lado del servidor mediante tokens Bearer.

Compilación desde el código fuente

Requiere Java 21+ y Maven 3.8+.

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

Versiones

La versión del servidor MCP coincide con la versión de hippodid-spring-boot-starter. Ambas deben estar en la misma versión para ser compatibles.

Licencia

Licencia Apache 2.0 — consulta LICENSE.