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
}

Letta MCP Server

Integrations

Letta MCP 服务器

快速设置

选项 1：使用 Node.js 运行

选项 2：使用 Docker 运行

目录结构

可用工具

代理管理

内存管理

刀具管理

其他工具

Docker 操作

使用 MCP 设置进行配置

Tools

Related Resources