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——你的代理的记忆会随之转移。

主要特性：

• 跨平台记忆 — 任何 MCP 客户端或通过 OAuth 的 ChatGPT 均可访问相同的记忆

• 结构化提取 — 原始文本被自动解析为带显著度评分的分类事实

• 时间衰减 — 记忆按类别自然消逝（技能是常青的，事件在 14 天后淡化）

• 角色隔离 — 每个代理/项目拥有独立的命名空间

• BYRAI — 自带 OpenAI、Anthropic 或 Gemini 密钥用于提取

Related MCP server: memory-mcp

快速开始

1. 获取 API 密钥

在 hippodid.com 注册，并从你的控制台创建 API 密钥。

2. 下载 JAR 包

从 GitHub Releases 下载最新版本。

3. 配置 Claude Desktop

将以下内容添加到你的 Claude Desktop 配置中（macOS 上的路径为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "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。