Letta Cloud MCP

Letta Cloud MCP服务器

英语| 日本语

用于连接的MCP（模型上下文协议）服务器 莱塔云.

使用来自MCP兼容代理（如Factory Droid、Claude Code和Cursor）的Letta Cloud的有状态内存系统。

特性

• 本地Letta云支持 -无需自托管，只需使用API密钥即可连接
• 内存块操作 -读写角色、人类、项目等记忆块
• 代理交互 -发送消息以触发代理学习
• 档案存储器 -搜索并添加长期记忆

安装

# Clone the repository
git clone https://github.com/wasedaigo/letta-cloud-mcp.git
cd letta-cloud-mcp

# Install dependencies
npm install

# Build
npm run build

全局安装（可选）

npm install -g .

配置

环境变量

工厂Droid配置

~/.factory/mcp.json 或 .factory/mcp.json:

{
  "mcpServers": {
    "letta-cloud": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/letta-cloud-mcp/dist/index.js"],
      "env": {
        "LETTA_API_KEY": "your-api-key-here",
        "LETTA_DEFAULT_AGENT_ID": "agent-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

Claude代码配置

claude mcp add letta-cloud \
  --command "node /path/to/letta-cloud-mcp/dist/index.js" \
  --env LETTA_API_KEY=your-api-key-here \
  --env LETTA_DEFAULT_AGENT_ID=agent-xxx

光标配置

~/.cursor/mcp.json:

{
  "mcpServers": {
    "letta-cloud": {
      "command": "node",
      "args": ["/path/to/letta-cloud-mcp/dist/index.js"],
      "env": {
        "LETTA_API_KEY": "your-api-key-here",
        "LETTA_DEFAULT_AGENT_ID": "agent-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

可用工具

代理管理

消息传递

内存块操作

档案存储器

用法示例

使用Droid

> List my Letta agents
(Droid calls list_agents tool)

> Save what I learned today to Letta:
> Understood the importance of preload scripts in ipcMain implementation
(Droid sends the learning via send_message tool → Letta autonomously updates memory)

> Show me the project memory block
(Droid calls get_memory_block tool for the project block)

编程式用法

// From an MCP client
await mcpClient.callTool("send_message", {
  message: "Remember: Adopted ESLint flat config because..."
});

// Direct memory update (external injection)
await mcpClient.callTool("update_memory_block", {
  block_id: "block-xxx",
  value: "Updated content..."
});

建筑

┌─────────────┐     MCP Protocol     ┌──────────────────┐     REST API     ┌──────────────┐
│   Droid     │ ◄──────────────────► │  letta-cloud-mcp │ ◄──────────────► │ Letta Cloud  │
│ Claude Code │       (stdio)        │                  │    (HTTPS)       │              │
│   Cursor    │                      │  @letta-ai/      │                  │ app.letta.com│
└─────────────┘                      │  letta-client    │                  └──────────────┘
                                     └──────────────────┘

Letta Cloud与自托管

故障排除

“需要LETTA_API_KEY环境变量”

未设置API密钥。从以下位置获取一个 莱塔云.

“agent_id是必需的”

集 LETTA_DEFAULT_AGENT_ID 或指定 agent_id 调用工具时。

连接错误

1. 验证API密钥是否有效
2. 检查 Letta云状态
3. 验证网络连接

许可证

麻省理工学院

相关链接

• 莱塔云
• Letta文件
• Letta TypeScript SDK
• 模型上下文协议
• 日本语版README