使用说明
HyperMemory MCP集成
人工智能助手的持久、交叉对话记忆。HyperMemory将知识存储为 超图 --节点、边缘和超节点——这样你的人工智能就能记住事实、偏好、决策以及它们之间的关系。
此存储库包含设置指南、技能文件和API参考资料，用于通过 MCP（模型上下文协议），the 命令行界面，或 REST API.
快速开始
| 平台 | 指南 | 授权方法 | 设置时间 |
|---|---|---|---|
| 光标IDE | MCP服务器 | OAuth（自动） | 2分钟 |
| 克劳德桌面/代码 | MCP服务器 | OAuth或API密钥 | 5分钟 |
| CLI/终端代理 | hm 命令 |
API密钥 | 3分钟 |
| REST API | HTTP端点 | API密钥或JWT | 5分钟 |
步骤1--获取凭据
- 注册地址： hypermory.io （免费版可用）
- 首选 app.hypermemory.io/集成
- 对于 MCP客户端 （Cursor，Claude）：使用OAuth——无需密钥，登录在浏览器中进行
- 对于 CLI或API：创建一个API密钥-它从
hm_后面是64个十六进制字符
第二步——连接
从上表中选择您的平台，并按照指南进行操作。
第3步——安装技能（可选但推荐）
放下一个 技能档案 输入你的人工智能工具来教它 当 和 怎么 在每条消息上自动使用内存。
运作原理
HyperMemory通过MCP（模型上下文协议）公开工具，MCP是一种开放标准，用于让AI助手访问外部功能。你的人工智能调用以下工具 hm_store 和 hm_recall 读取和写入内存。
AI Assistant ---> MCP (Streamable HTTP) ---> HyperMemory Server
https://api.hypermemory.io/mcp
认证
| 方法 | 用例 | 如何 |
|---|---|---|
| OAuth 2.1+PKCE | MCP客户端（Cursor、Claude、Windsurf） | 浏览器弹出，自动令牌管理 |
| API密钥 | CLI、REST API、服务器到服务器 | Authorization: Bearer hm_xxxx... 头球 |
OAuth是交互式MCP客户端的主要方法。服务器使用PKCE、动态客户端注册（RFC 7591）和授权服务器元数据（RFC 8414）实现了完整的OAuth 2.1授权代码流。身份由Supabase Auth提供。
API密钥以 hm_ 并在 仪表盘。它们可以作用于特定的图形。
数据模型
HyperMemory将知识存储为 超图 有三个基元：
节点
节点是一个单一的知识——事实、人、决策、技术、偏好等。
{
"key": "tech_redis",
"description": "Redis is used for rate limiting, session caching, and OAuth code storage",
"node_type": "technology",
"data": { "version": "7.x" }
}
每个节点都有一个唯一的 key （格式： {type}_{name})，人类可读 description，以及可选 data 结构化元数据的对象。服务器根据语义搜索的描述生成向量嵌入。
边（二元关系）
边以所描述的关系精确地连接两个节点。
{
"to_key": "tech_qdrant",
"relationship": "search pipeline depends on Qdrant for vector similarity matching"
}
关系应该是描述性的句子，而不是单个单词。服务器自动汇总长标签。
超边（组关系）
超边缘连接 3个或更多节点 参与一个不可分割的关系——比如项目团队、技术栈或系统架构。
{
"participant_keys": ["project_api", "tech_fastapi", "tech_redis", "tech_postgres"],
"relationship": "production API stack — all three are co-dependent"
}
使用移除测试：如果移除任何单个参与者仍然保持关系不变，请使用二元边。
节点类型
user person organization component event decision concept
artifact project technology preference fact skill
加上系统级类型： location, group, product, asset, document, URL.
多个图形
每个帐户可以有多个独立的内存图。Pro计划获得4，Business获得20，Enterprise不受限制。在仪表板上或通过 X-Graph-Id 头球
MCP工具
HyperMemory暴露 11个公共MCP工具。这些可用于任何连接的MCP客户端。
| 工具 | 目的 | 关键参数 |
|---|---|---|
hm_store |
保存新的内存节点 | key, description, node_type, data?, relationships? |
hm_recall |
搜索内存（混合：BM25+向量+会话） | query, max_results? （默认值20） |
hm_update |
修改现有节点 | key, description?, data?, node_type? |
hm_forget |
删除节点 | key, cascade? （默认为true） |
hm_get_overview |
图表统计数据和顶部节点 | include_top_nodes? （默认值10） |
hm_find_related |
从种子节点遍历图形 | start_node, query?, max_nodes?, max_depth? |
hm_ingest |
将密集文本分解为实体和边（LLM） | text, context? |
hm_upload_file |
将带有AI摘要的文件上传到S3（Pro+） | filename, content_base64, description? |
hm_list_files |
查询上传的文件 | file_type?, search?, limit? |
hm_timeline_write |
在时间线上写日记 | summary, meta? |
hm_timeline |
搜索过去的时间线事件 | query?, period?, node_key?, start?, end? |
搜索管道
hm_recall 运行并行混合搜索：
- 会话缓存 --最近访问的节点，按会话阶段加权
- BM25 --节点描述的全文搜索
- 矢量 --通过Qdrant嵌入实现语义相似性
- 边缘BM25 --关系标签的全文搜索
- 正则表达式回退 --其他方法不返回任何结果时的模式匹配
结果按照会话相关性、主题契合度和一般重要性的组合进行评分、去重复和排名。
富集
存储的节点由后台工作程序异步丰富，该工作程序：
- 检测并创建与现有节点的关系
- 根据本体对节点类型进行分类
- 生成结构化元数据
- 将节点链接到相关超级节点
计划和限制
| 计划 | 价格 | 查询/月 | 图表 | 文件存储 |
|---|---|---|---|---|
| 自由 | $0 | 2,000 | 1 | — |
| 基本 | 每月8美元 | 10000 | 1 | -- |
| 专业版 | 每月15美元 | 200000 | 4 | 1GB |
| 商业 | 每月50美元 | 500000 | 20 | 100GB |
| 企业 | 自定义 | 无限制 | 无限制 | 1 TB |
年度账单节省了约17%。所有付费计划都包括所有MCP工具。文件上传需要Pro或更高版本。
速率限制
|计划| API请求/分钟|编写工具/分钟|获取工具/分钟/读取工具/分钟| |------|-----------------|-----------------|-------------------|----------------| |免费|60|10|3|30| |基本|120|20|5|60| |Pro | 300 | 60 | 15 | 120| |商务|600|120|30|240| |企业|无限|300|60|600|
技能档案
技能档案教你的AI助手 怎么 自动使用HyperMemory。将一个放入工具的配置中：
| 文件 | 用于 | MCP服务器名称 |
|---|---|---|
| 技能/超媒体.md | 通用MCP客户端 | hypermemory |
| 技能/cursor.md | 光标IDE | user-hypermemory |
| 技能/cli.md | 终端代理（OpenClaw等） | N/A（使用 hm CLI） |
| 技能/chatgpt.txt | ChatGPT自定义指令 | 不适用 |
仓库结构
README.md Overview, data model, tools, plans (this file)
cursor/ Cursor IDE setup guide
claude/ Claude Desktop & Claude Code setup guide
cli/ CLI installation and command reference
api/ REST API endpoint reference
skills/ Drop-in skill files for AI tools
LICENSE MIT License
支持
- 问题： GitHub 问题
- 电子邮件： support@hypermemory.io
- 仪表板： app.hypermemory.io
许可证
麻省理工学院——见 许可证.
建造于 RunStack AI
