JinDaGe - Letta-MCP-server MCP Details

article

README

🚀 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
  }
}

Letta-MCP-server