Letta MCP 服务器

与 Letta API 对接的 Model Context Protocol (MCP) 服务器实现，用于管理代理、内存块和工具。此服务器提供以下功能：

特性

• 创建和管理 Letta 代理
• 列出并过滤可用代理
• 创建、读取、更新和管理内存块
• 列出内存块，支持过滤和分页
• 将内存块附加到代理，带有自定义标签
• 列出和管理代理工具
• 发送消息给代理并接收响应

安装

# 克隆仓库
git clone https://github.com/oculairmedia/Letta-MCP-server.git
cd letta-server

# 安装依赖项
npm install

# 启动服务器
node index.js

配置

将以下内容添加到 config.json 文件中：

{
  "api_key": "your_api_key",
  "host": "localhost",
  "port": 3000,
  "proxy_enabled": true
}

工具说明

内存块管理

• 创建内存块：

  {
    "success": true,
    "message": "Memory block created successfully.",
    "details": {
      "id": "block-123",
      "content": "Sample memory content."
    }
  }
  

• 读取内存块：

  {
    "success": true,
    "message": "Memory block retrieved.",
    "data": {
      "id": "block-123",
      "content": "Sample memory content."
    }
  }
  

代理管理

• 创建代理：

  {
    "success": true,
    "message": "Agent created successfully.",
    "details": {
      "id": "agent-456",
      "name": "Sample Agent"
    }
  }
  

• 列出代理：

  {
    "success": true,
    "message": "Agents retrieved.",
    "data": [
      {
        "id": "agent-456",
        "name": "Sample Agent"
      },
      // 更多代理...
    ]
  }
  

错误处理

所有 MCP 工具返回一致的错误格式：

{
  "success": false,
  "message": "An error occurred.",
  "error": "Invalid arguments provided.",
  "details": {
    "code": 400,
    "reason": "Bad Request"
  }
}

性能考虑

• 内存块支持分页，以高效处理大数据集
• 工具源代码在上传前经过验证
• 支持代理响应的流式传输，以处理长对话
• 自动清理旧资源
• 请求速率限制，防止 API 过载

贡献指南

1. Fork 仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 提交 Pull Request

许可证

此项目使用 MIT 许可证，详细信息见 LICENSE 文件。