Oculairmedia Letta MCP Server

🚀 Letta MCP 服务器

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 文件。