Oculairmedia Letta MCP Server

🚀 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 ファイルを参照してください。