Letta MCP 服务器
提供代理管理、内存操作以及与 Letta 系统集成的工具的服务器。
快速设置
选项 1:使用 Node.js 运行
# Development (with hot reload)
npm run dev:sse # SSE transport
# Production
npm run build # Build TypeScript first
npm run start:sse # SSE transport
选项 2:使用 Docker 运行
# Build and run locally
docker build -t letta-mcp-server .
docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp letta-mcp-server
# Or use the public image
docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest
目录结构
- index.js - 主入口点
core/
——核心服务器功能tools/
- 单独的工具实现transports/
- 服务器传输实现(stdio 和 SSE)
可用工具
代理管理
工具 | 描述 | 必需参数 | 可选参数 |
---|
create_agent | 创建新的 Letta 代理 | 名称、描述 | 模型,嵌入 |
list_agents | 列出所有可用的代理 | - | 筛选 |
prompt_agent | 向代理发送消息 | agent_id,消息 | - |
get_agent | 通过 ID 获取代理详细信息 | 代理 ID | - |
modify_agent | 更新现有代理 | agent_id,更新数据 | - |
delete_agent | 删除代理 | 代理 ID | - |
clone_agent | 克隆现有代理 | 源代理 ID、新代理名称 | override_existing_tools,项目 ID |
bulk_delete_agents | 删除多个代理 | - | 代理 ID、代理名称过滤器、代理标签过滤器 |
内存管理
工具 | 描述 | 必需参数 | 可选参数 |
---|
list_memory_blocks | 列出所有内存块 | - | 过滤器、agent_id、页面、页面大小、标签 |
create_memory_block | 创建新的内存块 | 名称、标签、值 | agent_id,元数据 |
read_memory_block | 读取内存块 | 区块 ID | 代理 ID |
update_memory_block | 更新内存块 | 区块 ID | 值、元数据、agent_id |
attach_memory_block | 将内存附加到代理 | block_id、agent_id | 标签 |
刀具管理
工具 | 描述 | 必需参数 | 可选参数 |
---|
list_tools | 列出所有可用的工具 | - | 过滤器、页面、页面大小 |
list_agent_tools | 列出特定代理的工具 | 代理 ID | - |
attach_tool | 将工具附加到代理 | 代理 ID | 工具 ID、工具 ID、工具名称 |
upload_tool | 上传新工具 | 名称、描述、源代码 | 类别,代理ID |
bulk_attach_tool_to_agents | 将一个工具附加到多个代理 | 工具 ID | 代理名称过滤器、代理标签过滤器 |
其他工具
- 模型管理:
list_llm_models
、 list_embedding_models
- 档案管理:
list_passages
、 create_passage
、 modify_passage
、 delete_passage
- MCP 服务器管理:
list_mcp_servers
、 list_mcp_tools_by_server
- 导入/导出:
export_agent
、 import_agent
Docker 操作
# View container logs
docker logs -f letta-mcp
# Stop the container
docker stop letta-mcp
# Update to latest version
docker pull ghcr.io/oculairmedia/letta-mcp-server:latest
docker stop letta-mcp
docker rm letta-mcp
docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest
使用 MCP 设置进行配置
将服务器添加到您的 mcp_settings.json:
"letta": {
"command": "node",
"args": [
"--no-warnings",
"--experimental-modules",
"path/to/letta-server/index.js"
],
"env": {
"LETTA_BASE_URL": "https://your-letta-instance.com",
"LETTA_PASSWORD": "yourPassword"
},
"disabled": false,
"alwaysAllow": [
"upload_tool",
"attach_tool",
"list_agents",
"list_memory_blocks"
],
"timeout": 300
}
对于远程实例,使用 URL 配置:
"remote_letta_tools": {
"url": "http://your-server:3001/sse",
"disabled": false,
"alwaysAllow": [
"attach_tool",
"list_agents",
"list_tools",
"get_agent"
],
"timeout": 120
}