串行内存MCP客户端
官方 模型上下文协议(MCP) SerialMemory云平台的客户端。\ 兼容 克劳德桌面, 光标, 基洛代码,以及任何启用MCP的IDE。
______________________________________________________________________
🚀 概述
SerialMemory MCP客户端是 瘦无状态代理 将MCP工具调用转发到:
https://api.serialmemory.dev/api/mcp/tools/
它包含 零后端逻辑 --所有情报都发生在SerialMemory Cloud上。
______________________________________________________________________
📦 安装
1.下载二进制文件
➡️ https://github.com/sblanchard/SerialMemory-MCP/releases
- Windows:串行内存-mcp-win-x64.zip
- macOS ARM:串行内存-mcp-macOS-arm64.tar.gz
- Linux:串行内存-mcp-Linux-x64.tar.gz
提取任何地方。
______________________________________________________________________
⚙️ 配置
Linux/macOS
export SERIALMEMORY_ENDPOINT="https://api.serialmemory.dev"
export SERIALMEMORY_API_KEY="your-api-key"Windows PowerShell
setx SERIALMEMORY_ENDPOINT "https://api.serialmemory.dev"
setx SERIALMEMORY_API_KEY "your-api-key"从以下位置获取API密钥:\ https://app.serialmemory.dev/dashboard
______________________________________________________________________
▶️ 跑步
直接执行
./serialmemory-mcp码头工人
docker run -it \
-e SERIALMEMORY_ENDPOINT="https://api.serialmemory.dev" \
-e SERIALMEMORY_API_KEY="your-api-key" \
serialcoder/serialmemory-mcp:latest______________________________________________________________________
🔌 MCP集成
克劳德桌面
修改:
~/Library/Application Support/Claude/claude_desktop_config.json
添加:
{
"mcpServers": {
"serialmemory": {
"command": "/path/to/serialmemory-mcp"
}
}
}重启克劳德。
______________________________________________________________________
光标
~/.cursor/mcp.json
{
"serialmemory": {
"command": "/path/to/serialmemory-mcp"
}
}______________________________________________________________________
基洛代码
~/.kilocode/mcp.json
{
"servers": {
"serialmemory": {
"command": "/path/to/serialmemory-mcp"
}
}
}______________________________________________________________________
🧩 工具
| 工具 | 说明 |
|---|---|
| memory.search | 语义和关键字搜索 |
| memory.add | 添加内存项 |
| memory.update | 更新现有内存 |
| memory.delete | 删除内存 |
| memory.list_recent | 最近添加的记忆 |
| session.list | 对话会话 |
| graph.query | 知识图查询 |
所有呼叫代理到:\ POST /api/mcp/tools/
______________________________________________________________________
🏗 发展
git clone https://github.com/sblanchard/SerialMemory-MCP
cd SerialMemory-MCP
dotnet build
dotnet run --project SerialMemory.Mcp______________________________________________________________________
🐳 Dockerfile(包括)
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY . .
ENTRYPOINT ["./serialmemory-mcp"]______________________________________________________________________
🔧 故障排除
Mac:SSE传输身份验证失败
错误:
HTTP 404: Invalid OAuth error response: SyntaxError: JSON Parse error: Unexpected EOF. Raw body:原因: Mac上带有SSE传输的MCP SDK执行OAuth发现,点击 /.well-known/oauth-authorization-server。如果返回404且正文为空,则JSON解析失败。
解决方案: 使用 http 运输而不是 sse:
{
"mcpServers": {
"serialmemory": {
"type": "http",
"url": "http://localhost:4545/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}这适用于所有平台(Windows、Linux、macOS)。
______________________________________________________________________
🔐 安全
- 无本地存储
- 无嵌入
- 没有数据库访问权限
- 纯HTTPS代理
- 在企业环境中安全
______________________________________________________________________
🗒 更新日志
v1.0.0
- 首次公开发布
- Claude、Cursor、Kilo代码支持
- Docker构建
- 多操作系统支持
- 无状态MCP代理
______________________________________________________________________
📜 许可证
麻省 理工 学院 执照© 序列编码器
