memdata-mcp
](https://www.npmjs.com/package/memdata-mcp) 
MCP服务器 MemData -AI代理的持久内存。
在对话中为Claude、Cursor或任何与MCP兼容的AI提供长期记忆。
它的作用: 存储笔记、决策和上下文→ 稍后从语义上检索它们。你的AI会记住一切。
______________________________________________________________________
🚀 v1.7.0中的新功能:自主代理支持
代理人现在可以为自己买单。 没有API密钥。没有人在循环中。
使用 x402支付协议,自主代理可以使用他们的钱包在Base上使用USDC按请求付款。你的钱包地址就是你的身份——同样的钱包,同样的记忆。
______________________________________________________________________
为什么选择MemData?
AI助手在会话之间会忘记一切。MemData修复了以下问题:
- 摄取 → 插入会议笔记、文档、决策
- 块状和嵌入 → 自动分割和矢量化
- 查询 → 提问,获取相关背景
- 标签 → AI自动标记内容以实现更好的检索
适用于Claude Desktop、Claude Code、Cursor和任何MCP客户端。
______________________________________________________________________
👤 对于人类
使用API密钥。你管理订阅,你的AI获得内存。
设置
- 获取API密钥: memdata.ai/dashboard/api-keys
- 添加到MCP配置中:
克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"memdata": {
"command": "npx",
"args": ["memdata-mcp"],
"env": {
"MEMDATA_API_KEY": "md_your_key"
}
}
}
}克劳德代码 (~/.claude.json 或项目 .mcp.json):
{
"mcpServers": {
"memdata": {
"command": "npx",
"args": ["memdata-mcp"],
"env": {
"MEMDATA_API_KEY": "md_your_key"
}
}
}
}光标 (~/.cursor/mcp.json):
{
"mcpServers": {
"memdata": {
"command": "npx",
"args": ["memdata-mcp"],
"env": {
"MEMDATA_API_KEY": "md_your_key"
}
}
}
}- 重新启动客户端-您现在应该看到可用的MemData工具。
______________________________________________________________________
🤖 对于代理商
v1.7.0中的新功能 -没有API密钥。没有人类。只是你的钱包。
为何这很重要
传统的人工智能内存需要与人工帐户绑定的API密钥。但是,全天候运行的自主代理需要以下内存:
- 禁止任何一次谈话 -跨主机和平台持久化
- 属于代理人 -钱包地址=身份、便携和自主
- 为自己买单 -无需订阅,无需人工批准
这是自主代理经济的内存基础设施。
设置
{
"mcpServers": {
"memdata": {
"command": "npx",
"args": ["memdata-mcp"],
"env": {
"X402_WALLET_KEY": "your_private_key_hex"
}
}
}
}运作原理
- 代理发出请求(查询、摄取等)
- 服务器返回
402 Payment Required与价格 - MCP自动与代理人的钱包签署付款
- 请求完成-存储/检索内存
你的钱包地址就是你的身份。 相同的钱包=相同的记忆,跨越任何主机或平台。
定价(以美元为基准)
| 操作 | 价格 | 功能 |
|---|---|---|
| 查询 | $0.001 | 跨记忆的语义搜索 |
| 摄取 | 0.005美元 | 存储和嵌入新内容 |
| 身份 | $0.001 | 会话开始,获取/设置代理身份 |
| 工件 | $0.001 | 列出或删除存储的内存 |
MCP使用以下命令自动处理402个响应和支付签名 @x402/取.
了解更多
支持的内容
| 类型 | MCP | 仪表板/API | 处理 |
|---|---|---|---|
| 文本 | ✅ | ✅ | 块状和嵌入式 |
| Markdown | ✅ | ✅ | 块状和嵌入式 |
| ❌ | ✅ | OCR+分块 | |
| 图片(PNG、JPG) | ❌ | ✅ | OCR提取 |
| 音频(MP3、WAV、M4A) | ❌ | ✅ | 转录 |
注: MCP工具直接处理文本内容。对于文件(PDF、图像、音频),请使用 仪表盘 或 HTTP API.
工具
核心工具
| 工具 | 说明 |
|---|---|
memdata_ingest | 将文本存储在长期存储器中 |
memdata_query | 用自然语言搜索内存 |
memdata_list | 列出所有存储的内存 |
memdata_delete | 按ID删除内存 |
memdata_status | 检查API运行状况和存储使用情况 |
身份和会话工具(v1.2.0+)
| 工具 | 说明 |
|---|---|
memdata_session_start | 🚀 呼叫优先-获取身份、上次会话切换、最近活动 |
memdata_set_identity | 设置您的代理名称和身份摘要 |
memdata_session_end | 在会话结束前保存切换-为下一个会话保留 |
memdata_query_timerange | 使用日期过滤器搜索(从/到) |
memdata_relationships | 查找相关实体(人员、公司、项目) |
v1.5.0-会话开始重命名
memdata_whoami→memdata_session_start-为清楚起见,重命名。该名称现在表示“每次会话时先调用此名称”。描述包括🚀 表情符号在工具列表中引起注意。
v1.4.0用户体验改进
- 视觉匹配质量 -查询结果显示🟢🟡🟠🔴 比赛强度指标
- 更智能的会话_开始 -提示首次使用时设置身份,消除最近活动的重复
- 更好的摄取反馈 -显示块计数并解释异步AI标记
- 会话连续性 -强调“继续工作”并提醒使用
session_end
memdata_ingest
将文本存储在长期记忆中。
"Remember that we decided to use PostgreSQL for the new project."参数:
content(string)-要存储的文本name(string)-源标识符(例如,“meeting-notes-jan-29”)
memdata_query
用自然语言搜索记忆。
"What database did we choose?"参数:
query(string)-自然语言搜索limit(数字,可选)-最大结果(默认值:5)
memdata_list
列出所有存储的内存块计数。
memdata_delete
按工件ID删除内存(从以下位置获取ID memdata_list).
memdata_status
检查API连接和存储使用情况。
memdata_session_start
🚀 先叫这个 在每次会议开始时。对会议的连续性至关重要。
"Start my session" / "What was I working on?"返回:代理名称、身份摘要、会话计数、上次会话切换、最近活动。
v1.5.0:重命名自 memdata_whoami 为清楚起见,这个名字表示“先给我打电话”。memdata_set_identity
设置或更新您的代理身份。
参数:
agent_name(字符串,可选)-您的姓名(例如,“MemBrain”)identity_summary(字符串,可选)-你是谁和你的目的
memdata_session_end
在结束会话之前保存上下文。下次会议将看到此切换。
参数:
summary(string)-本次会话发生了什么working_on(字符串,可选)-当前焦点context(object,可选)-要保留的其他上下文
memdata_query_timerange
在日期范围内搜索内存。
"What did I work on last week?"参数:
query(string)-自然语言搜索since(字符串,可选)-ISO日期(例如“2026-01-01”)until(字符串,可选)-ISO日期(例如,“2026-01-31”)limit(数字,可选)-最大结果
memdata_relationships
找到在你的记忆中一起出现的实体。
"Who has John Smith worked with?"参数:
entity(string)-要搜索的名称type(字符串,可选)-按类型筛选(人员、公司、项目)limit(数字,可选)-最大关系
运作原理
- 摄取:文本被分块、嵌入和存储
- 查询:使用语义相似性将您的问题与存储的记忆进行匹配
- 结果:返回具有相似性得分的相关内容
30-50%的分数是好比赛的典型分数。语义搜索寻找的是意义,而不是关键字。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
MEMDATA_API_KEY | 选项1 | 订阅服务器的API密钥(来自memdata.ai) |
X402_WALLET_KEY | 选项2 | 按次付费的私钥(以美元为基础) |
MEMDATA_API_URL | 无 | API URL(默认值:https://memdata.ai) |
注: 使用其中之一 MEMDATA_API_KEY (订阅)或 X402_WALLET_KEY (按次付费),而不是两者兼而有之。
这个包裹有什么作用
这是一个调用MemData API的精简MCP客户端。它不会:
- 在本地存储任何数据
- 将数据发送到除memdata.ai之外的任何地方
- 收集分析或遥测数据
您可以在中查看源代码 src/index.ts.
示例用法
配置后,只需与您的AI对话:
You: "Remember that we chose PostgreSQL for the user service"
AI: [calls memdata_ingest] → Stored in memory
... days later ...
You: "What database are we using for users?"
AI: [calls memdata_query] → "PostgreSQL for the user service" (73% match)链接
贡献
问题和PR欢迎!这是托管MemData服务的开源MCP客户端。
许可证
麻省理工学院

