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