Claude的超级内存MCP集成
该项目提供了一个自定义MCP（模型上下文协议）服务器，该服务器将Supermemory与Claude Desktop集成在一起，允许您直接从Claude对话中搜索和管理您的记忆。
⚠️ 官方超级内存MCP可用
Supermemory现在提供具有SSE传输的官方MCP服务器。您可以使用以下任一方式：
选项1：官方超级内存MCP（推荐）
从获取最新版本 App.supermemory.ai:
- 登录您的超级内存帐户
- 导航到“连接到您的AI”→ 选择克劳德
- 获取您唯一的MCP URL：
https://mcp.supermemory.ai/[YOUR_UNIQUE_ID]/sse - 安装方式：
npx install-mcp [YOUR_URL] --client claude
益处：始终保持最新状态，官方维护，苏格兰和南方能源公司运输
选项2：此自定义实现
将此存储库用于：
- 自定义修改和扩展
- 了解MCP服务器的工作原理
- 离线/本地优先操作
- 与其他MCP兼容工具集成
备注：这两个实现都使用Supermemory的v3 API。此自定义版本使用stdio传输而不是SSE。
特性
- 搜索记忆：在所有Supermemory文档中进行语义搜索
- 添加记忆：在超级内存中存储新信息和对话
- 与你的回忆聊天：向Claude提问，它将在您的Supermemory数据库中搜索相关上下文
先决条件
- Python 3.10或更高版本
- Claude桌面应用程序
- 超级内存帐户和API密钥
安装说明
1.安装依赖项
cd /Users/franksimpson/CascadeProjects/supermemory-claude-integration
source venv/bin/activate # If venv already exists
# OR create a new venv:
# python3 -m venv venv
# source venv/bin/activate
pip install -r requirements.txt2.设置API密钥
创建一个 .env 项目目录中的文件：
cp .env.example .env然后编辑 .env 并添加您的Supermemory API密钥：
SUPERMEMORY_API_KEY=your_actual_api_key_here从以下位置获取API密钥：https://console.supermemory.ai
3.配置克劳德桌面
运行安装脚本以自动配置Claude Desktop：
source venv/bin/activate
SUPERMEMORY_API_KEY=your_api_key_here python setup_claude_config.py或者手动将配置添加到Claude Desktop配置文件中：
位置: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"supermemory": {
"command": "/path/to/supermemory-claude-integration/venv/bin/python",
"args": [
"/path/to/supermemory-claude-integration/supermemory_mcp_server.py"
],
"env": {
"SUPERMEMORY_API_KEY": "your_api_key_here"
}
}
}
}备注：替换 /path/to/supermemory-claude-integration/ 根据您的实际项目路径。如果您已经配置了其他MCP服务器，只需将“supermemory”条目添加到现有的“mcpServers”对象中即可。
3.重新启动克劳德桌面
更新配置文件后，完全退出并重新启动Claude Desktop以使更改生效。
4.验证集成
在Claude Desktop中，您现在应该可以看到可用的超级内存工具。试着问：
- “在我的记忆中搜索有关Aura的信息”
- “你对我的项目了解多少？”
- “在我的记忆中搜索有关AI同伴的信息”
可用工具
1.搜索_内存
使用语义搜索在所有Supermemory记忆中搜索。
参数:
query（必填）：搜索查询limit（可选）：最大结果数（默认值：5）
示例:
Search my memories for: "AI agent architecture"2.add_memory
将新内存/文档添加到超级内存。
参数:
content（必填）：要存储的内容title（可选）：存储器的标题metadata（可选）：附加元数据作为键值对
示例:
Add this to my memories: "Today I learned about MCP servers and how they integrate with Claude"测试
测试搜索功能
运行测试脚本以验证您的超级内存连接：
source venv/bin/activate
python test_search.py这将搜索您现有的记忆并显示结果。
直接测试MCP服务器
您可以单独测试MCP服务器：
source venv/bin/activate
python supermemory_mcp_server.py服务器将启动并等待stdin上的MCP协议消息。
用法示例
在Claude Desktop中配置后，您可以进行以下对话：
示例1：搜索记忆
You: What projects have I worked on related to AI agents?
Claude: Let me search your memories... [uses search_memories tool]示例2：添加记忆
You: Remember that I prefer to use Python for backend development
Claude: [uses add_memory tool to store this preference]示例3：情境感知对话
You: Based on what you know about my Aura project, what should I focus on next?
Claude: [searches memories for Aura project details and provides recommendations]将克劳德对话上传到超级内存
要自动将Claude对话上传到Supermemory，您可以：
- 手动上传：复制重要的对话片段并使用
add_memory工具 - 批量上传：将对话另存为文本文件，并使用Supermemory API上传
项目结构
supermemory-claude-integration/
├── README.md # This file
├── requirements.txt # Python dependencies
├── supermemory_mcp_server.py # MCP server implementation
├── test_search.py # Test script for searching memories
└── venv/ # Python virtual environment故障排除
MCP服务器未在Claude中显示
- 检查配置文件路径是否正确：
~/Library/Application Support/Claude/claude_desktop_config.json - 验证配置中的Python路径是否指向venv的Python
- 确保Claude Desktop已完全重新启动（退出并重新打开）
- 检查Claude Desktop日志中是否有任何错误消息
搜索不返回结果
- 验证您的API密钥是否正确
- 检查您的超级内存帐户中是否有内存，网址为https://console.supermemory.ai
- 试着跑步
test_search.py验证连接是否正常工作
API错误
- 确保您的Supermemory API密钥有效
- 检查您的互联网连接
- 验证API终结点是否可访问
API密钥安全
重要：API密钥当前在此项目中是硬编码的。对于生产使用，您应该：
- 使用环境变量
- 将密钥存储在安全位置
- 永远不要将API密钥提交到版本控制
要使用环境变量，请执行以下操作：
export SUPERMEMORY_API_KEY="your_key_here"然后更新MCP服务器配置，使JSON中不包含密钥（它将使用环境变量）。
后续步骤
- 添加对话导出功能
- 实现自动对话跟踪
- 添加对按标签/元数据过滤的支持
- 创建用于管理内存的UI
资源
许可证
麻省理工学院