🚀 Letta MCP 服务器
Letta MCP 服务器是一个强大的工具，它提供代理管理、内存操作以及与 Letta 系统集成的功能，能有效提升系统的管理效率和集成能力。
🚀 快速开始
📦 安装指南
本服务器提供两种运行方式，你可以根据自己的需求进行选择。
选项1：使用 Node.js 运行
# 开发模式（带热重载）
npm run dev:sse # 使用 SSE 传输
# 生产模式
npm run build # 首先构建 TypeScript
npm run start:sse # 使用 SSE 传输
选项2：使用 Docker 运行
# 在本地构建并运行
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
# 或使用公共镜像
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/- 服务器传输实现（标准输入输出和 SSE）
可用工具
代理管理
| 属性 | 详情 |
|---|---|
| 工具 | 描述 |
create_agent |
创建新 Letta 代理，必填参数：name, description；可选参数：model, embedding |
list_agents |
列出所有可用代理，无必填参数；可选参数：filter |
prompt_agent |
向代理发送消息，必填参数：agent_id, message；无可选参数 |
get_agent |
根据 ID 获取代理详情，必填参数：agent_id；无可选参数 |
modify_agent |
更新现有代理，必填参数：agent_id, update_data；无可选参数 |
delete_agent |
删除代理，必填参数：agent_id；无可选参数 |
clone_agent |
克隆现有代理，必填参数：source_agent_id, new_agent_name；可选参数：override_existing_tools, project_id |
bulk_delete_agents |
批量删除代理，无必填参数；可选参数：agent_ids |
内存管理
| 属性 | 详情 |
|---|---|
| 工具 | 描述 |
list_memory_blocks |
列出所有内存块，无必填参数；可选参数：filter |
get_memory_block |
获取具体内存块信息，必填参数：memory_id；无可选参数 |
create_memory_block |
创建新内存块，必填参数：content, label；可选参数：metadata |
update_memory_block |
更新现有内存块，必填参数：memory_id, content；可选参数：metadata |
delete_memory_block |
删除内存块，必填参数：memory_id；无可选参数 |
工具管理
| 属性 | 详情 |
|---|---|
| 工具 | 描述 |
upload_tool |
上传新工具，必填参数：tool_name, tool_file；可选参数：description |
attach_tool |
将工具附加到代理，必填参数：agent_id, tool_id；无可选参数 |
list_tools |
列出所有可用工具，无必填参数；可选参数：filter |
Docker 操作
# 查看运行中的容器
docker ps | grep letta-mcp-server
# 进入容器
docker exec -it letta-mcp-server /bin/sh
配置说明
在 mcp_settings.json 中添加以下配置：
{
"letta_mcp": {
"host": "localhost",
"port": 3001,
"disabled": false,
"always_allow": [
"upload_tool",
"attach_tool",
"list_agents",
"list_memory_blocks"
],
"timeout": 300
}
}
对于远程实例，可以使用以下配置：
{
"remote_letta_tools": {
"url": "http://your-server:3001/sse",
"disabled": false,
"always_allow": [
"attach_tool",
"list_agents",
"list_tools",
"get_agent"
],
"timeout": 120
}
}