Letta MCP サーバー
エージェント管理、メモリ操作、Letta システムとの統合のためのツールを提供するサーバー。
クイックセットアップ
オプション1: Node.jsで実行する
# Development (with hot reload)
npm run dev:sse # SSE transport
# Production
npm run build # Build TypeScript first
npm run start:sse # SSE transport
オプション2: Dockerで実行する
# Build and run locally
docker build -t letta-mcp-server .
docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp letta-mcp-server
# Or use the public image
docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest
ディレクトリ構造
- index.js - メインエントリポイント
core/
- コアサーバー機能tools/
- 個々のツールの実装transports/
- サーバートランスポート実装 (stdio および SSE)
利用可能なツール
エージェント管理
道具 | 説明 | 必須パラメータ | オプションパラメータ |
---|
create_agent | 新しいLettaエージェントを作成する | 名前、説明 | モデル、埋め込み |
list_agents | 利用可能なエージェントをすべて一覧表示する | - | フィルター |
prompt_agent | エージェントにメッセージを送信する | エージェントID、メッセージ | - |
get_agent | IDでエージェントの詳細を取得する | エージェントID | - |
modify_agent | 既存のエージェントを更新する | エージェントID、更新データ | - |
delete_agent | エージェントを削除する | エージェントID | - |
clone_agent | 既存のエージェントのクローンを作成する | ソースエージェントID、新しいエージェント名 | 既存のツールを上書き、プロジェクトID |
bulk_delete_agents | 複数のエージェントを削除する | - | エージェントID、エージェント名フィルター、エージェントタグフィルター |
メモリ管理
道具 | 説明 | 必須パラメータ | オプションパラメータ |
---|
list_memory_blocks | すべてのメモリブロックを一覧表示する | - | フィルター、エージェントID、ページ、ページサイズ、ラベル |
create_memory_block | 新しいメモリブロックを作成する | 名前、ラベル、値 | エージェントID、メタデータ |
read_memory_block | メモリブロックを読み取る | ブロックID | エージェントID |
update_memory_block | メモリブロックを更新する | ブロックID | 値、メタデータ、エージェントID |
attach_memory_block | エージェントにメモリをアタッチする | ブロックID、エージェントID | ラベル |
ツール管理
道具 | 説明 | 必須パラメータ | オプションパラメータ |
---|
list_tools | 利用可能なツールをすべて一覧表示する | - | フィルター、ページ、ページサイズ |
list_agent_tools | 特定のエージェントのツールを一覧表示する | エージェントID | - |
attach_tool | エージェントにツールをアタッチする | エージェントID | ツールID、ツールID、ツール名 |
upload_tool | 新しいツールをアップロードする | 名前、説明、ソースコード | カテゴリー、エージェントID |
bulk_attach_tool_to_agents | 複数のエージェントにツールをアタッチする | ツールID | エージェント名フィルター、エージェントタグフィルター |
追加ツール
- モデル管理:
list_llm_models
、 list_embedding_models
- アーカイブ管理:
list_passages
、 create_passage
、 modify_passage
、 delete_passage
- MCP サーバー管理:
list_mcp_servers
、 list_mcp_tools_by_server
- インポート/エクスポート:
export_agent
、 import_agent
Docker 操作
# View container logs
docker logs -f letta-mcp
# Stop the container
docker stop letta-mcp
# Update to latest version
docker pull ghcr.io/oculairmedia/letta-mcp-server:latest
docker stop letta-mcp
docker rm letta-mcp
docker run -d -p 3001:3001 -e PORT=3001 -e NODE_ENV=production --name letta-mcp ghcr.io/oculairmedia/letta-mcp-server:latest
MCP設定による構成
mcp_settings.json にサーバーを追加します。
"letta": {
"command": "node",
"args": [
"--no-warnings",
"--experimental-modules",
"path/to/letta-server/index.js"
],
"env": {
"LETTA_BASE_URL": "https://your-letta-instance.com",
"LETTA_PASSWORD": "yourPassword"
},
"disabled": false,
"alwaysAllow": [
"upload_tool",
"attach_tool",
"list_agents",
"list_memory_blocks"
],
"timeout": 300
}
リモート インスタンスの場合は、URL 構成を使用します。
"remote_letta_tools": {
"url": "http://your-server:3001/sse",
"disabled": false,
"alwaysAllow": [
"attach_tool",
"list_agents",
"list_tools",
"get_agent"
],
"timeout": 120
}