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

Related MCP server: A2A Client MCP Server

ディレクトリ構造

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
}