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

可用工具

代理管理

内存管理

工具管理

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