Letta MCP 服务器

Name: Letta MCP Server
Author: oculairmedia

提供代理管理、内存操作以及与 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

Related MCP server: A2A Client MCP Server

目录结构

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 }