HippoDid MCP Server

HippoDid MCP 服务
为 AI Agent 提供持久、可移植的记忆。你的 AI 会在会话之间忘记所有内容，而 HippoDid 会记住。

---

HippoDid MCP 服务

HippoDid（Model Context Protocol）服务，可将 Claude Code、Claude Desktop、ChatGPT、Gemini CLI、Codex CLI、Cursor 以及任何兼容 MCP 的客户端连接到持久化的 AI 角色记忆。

HippoDid 是什么？

HippoDid 是面向 AI Agent 的云端记忆基础设施。它会将结构化记忆（偏好、决策、技能、人际关系）存储在可搜索的数据库中，并在不同会话、工具和 AI 提供商之间检索这些记忆。在 Claude Code 中写入记忆，在 ChatGPT 中回想。由 Cursor 切换到 Gemini 时，Agent 的记忆也会随之迁移。

主要功能：

• 跨平台记忆 — 可通过任何 MCP 客户端或 OAuth 登录的 ChatGPT 访问相同记忆
• 结构化提取 — 自动将原始文本解析为带有显著性评分的分类事实
• 时间衰减 — 记忆会按类别自然淡化（技能长期有效，事件会在 14 天内淡化）
• 角色隔离 — 每个 Agent/项目都有自己的记忆命名空间
• BYOK AI — 使用你自己的 OpenAI、Anthropic 或 Gemini 密钥进行提取

快速开始

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 工具

工具	描述
create_character	创建用于存储记忆的新角色
list_characters	列出你可以访问的所有角色
add_memory	通过 AUDN 流程添加记忆（基于规则的显著性评分 + 去重）
add_memory_direct	直接写入记忆，绕过 AUDN 流程（Starter+ 套餐）
search_memories	对记忆进行语义 + 关键词混合搜索
sync_file	将本地文件同步到 HippoDid 云端
import_document	导入文档并提取记忆（Starter+ 套餐）
list_synced_files	列出角色同步到云端的文件
get_sync_status	获取角色的同步状态摘要
export_character	将角色的所有记忆导出为 Markdown
add_watch_path	同步文件并注册路径，以便进行后台跟踪
list_watch_paths	列出此会话中所有受监控的文件路径
force_sync	强制立即同步所有受监控的路径
configure_ai	配置租户 BYOK AI 提供商
test_ai_config	测试已保存的 AI 提供商配置的连接情况

环境变量

变量	必填	默认值	描述
HIPPODID_API_KEY	是	—	你的 HippoDid API 密钥
HIPPODID_CHARACTER_ID	否	—	用于后台同步的默认角色 UUID
HIPPODID_BASE_URL	否	https://api.hippodid.com	API 基础 URL
MCP_SYNC_INTERVAL	否	300	后台同步间隔（秒）
MCP_AUTO_CAPTURE	否	false	禁用后台监视器（由 AI 处理同步）
MCP_AUTO_RECALL	否	false	禁用后台数据加载（由 AI 处理下载）
MCP_RECALL_CACHE_TTL	否	120	搜索结果缓存有效期（秒）

架构

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。