使用说明
HippoDid MCP Server
Persistent, portable memory for AI agents. Your AI forgets everything between sessions. HippoDid remembers.
HippoDid MCP服务器
MCP（模型上下文协议）服务器 HippoDid --将Claude Code、Claude Desktop、ChatGPT、Gemini CLI、Codex CLI、Cursor和任何与MCP兼容的客户端连接到持久的AI字符内存。
HippoDid是什么？
HippoDid是一个用于AI代理的云内存基础设施。它将结构化记忆（偏好、决策、技能、关系）存储在可搜索的数据库中，并在会话、工具和人工智能提供商之间检索它们。用Claude Code编写内存，在ChatGPT中调用它。从光标切换到双子座——你的代理人的记忆也会随之而去。
主要特点：
- 跨平台内存 --通过OAuth从任何MCP客户端或ChatGPT访问相同的内存
- 结构化提取 --原始文本会自动解析为具有显著性得分的分类事实
- 时间衰减 --记忆按类别自然消退（技能常青，事件在14天内消退）
- 角色范围 --每个代理/项目都有自己的内存命名空间
- BYOK AI --携带您自己的OpenAI、Anthropic或Gemini密钥进行提取
快速开始
1.获取API密钥
注册地址： hippodi.com 并从您的仪表板创建一个API密钥。
2.下载JAR文件
从下载最新版本 GitHub 发布.
3.配置克劳德桌面
添加到您的Claude桌面配置(~/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.开始使用
让克劳德记住事情、搜索记忆、同步文件等等。
MCP工具
| 工具 | 说明 |
|---|---|
create_character |
创建一个新角色来存储记忆 |
list_characters |
列出您可以访问的所有字符 |
add_memory |
通过AUDN管道添加内存（基于规则的显著性+去重） |
add_memory_direct |
直接写入内存，绕过AUDN管道（Starter+层） |
search_memories |
跨记忆的混合语义+关键字搜索 |
sync_file |
将本地文件同步到HippoDid云 |
import_document |
导入文档并提取记忆（初学者+层） |
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 |
搜索结果缓存TTL（秒） |
建筑
Claude Desktop → stdio (JSON-RPC) → McpServerRunner → HippoDidClient → HTTP → HippoDid REST API
MCP服务器使用 河马春季靴启动器 通过HTTP与HippoDod REST API进行通信。所有身份验证和租户隔离都是通过Bearer令牌在服务器端处理的。
从源头构建
需要Java 21+和Maven 3.8+。
mvn clean package -DskipTests
java -jar target/hippodid-mcp-server-1.1.0.jar
版本控制
MCP服务器版本与 河马春季靴启动器 版本。为了兼容，两者必须使用相同的版本。
许可证
Apache许可证2.0——请参阅 许可证.
