Eagle MCP サーバー (非公式)
Eagle用のモデルコンテキストプロトコル（MCP）サーバー。Wiki
JPG/JPEGPNGPDFSVGMP4MP3FBXOBJEPSTIF``TIFFWebPBMPICORAW等
イーグル: https://eagle.cool/
Eagle API ドキュメント: https://api.eagle.cool/
要件
Python 3.13
Related MCP server: Alchemy MCP Server
前提条件
必要な依存関係をインストールします。
uv sync使用法
Eagleアプリを起動します。
次のコマンドを実行して、この MCP サーバーを起動します。
uv run main.py
# To use a different endpoint:
# EAGLE_API_BASE_URL=http://localhost:12345 uv run main.pySSEを使用してMCPサーバーに接続する
最も人気のある MCP クライアント (Claude Desktop、Cursor、Windsurf) はすべて、次の構成形式を使用します。
{
"mcpServers": {
"eagle-mcp-server": {
"url": "http://localhost:8000/mcp"
}
}
}VSコード
"mcp": {
"servers": {
"eagle-mcp-server": {
"type": "sse",
"url": "http://localhost:8000/mcp"
}
}
}ツール
サポートされている | 操作ID | APIエンドポイント | 有効（デフォルト） | カテゴリ |
✅ |
| /api/接続 | MCP | |
✅ |
| /api/アプリケーション/情報 | ⚫︎ | 応用 |
✅ |
| /api/フォルダ/作成 | ⚫︎ | フォルダ |
✅ |
| /api/フォルダ/名前変更 | フォルダ | |
✅ |
| /api/フォルダ/更新 | ⚫︎ | フォルダ |
✅ |
| /api/フォルダ/リスト | ⚫︎ | フォルダ |
✅ |
| /api/folder/listRecent | フォルダ | |
✅ |
| /api/item/addFromURL | アイテム | |
✅ |
| /api/item/addFromURLs | アイテム | |
✅ |
| /api/item/addFromPath | ⚫︎ | アイテム |
✅ |
| /api/item/addFromPaths | アイテム | |
✅ |
| /api/item/ブックマークの追加 | アイテム | |
✅ |
| /api/アイテム/情報 | ⚫︎ | アイテム |
✅ |
| /api/item/ソース | ⚫︎ | アイテム |
✅ |
| /api/item/サムネイル | アイテム | |
✅ |
| /api/アイテム/リスト | ⚫︎ | アイテム |
✅ |
| /api/item/ゴミ箱へ移動 | ⚫︎ | アイテム |
✅ |
| /api/item/refreshPalette | アイテム | |
✅ |
| /api/item/refreshThumbnail | アイテム | |
✅ |
| /api/item/update | ⚫︎ | アイテム |
✅ |
| /api/ライブラリ/情報 | ⚫︎ | 図書館 |
✅ |
| /api/ライブラリ/履歴 | 図書館 | |
✅ |
| /api/ライブラリ/スイッチ | 図書館 | |
✅ |
| /api/ライブラリ/アイコン | 図書館 | |
[ ] | ... | ... | ... |
MCP サーバー API ドキュメント:
ユースケース
1) 同じホスト（推奨）
flowchart LR
subgraph 192.168.1.100
direction LR
subgraph FileSystem [File System]
end
subgraph EagleApp [Eagle App<br/>localhost:41595]
end
subgraph MCPServer [MCP Server<br/>localhost:8000]
end
subgraph MCPClient [MCP Client]
end
end
EagleApp ==> MCPServer e1@==> MCPClient
MCPClient e2@==> MCPServer ==> EagleApp
EagleApp ==> FileSystem
FileSystem ==> EagleApp
e1@{ animate: true }
e2@{ animate: true }ファイルシステムに直接アクセスできます。
2) 同じホスト (Eagle App、MCP サーバー) + 他のホスト (MCP クライアント)
flowchart LR
subgraph 192.168.1.100
subgraph FileSystem [File System]
end
subgraph EagleApp [Eagle App<br/>localhost:41595]
end
subgraph MCPServer [MCP Server<br/>localhost:8000]
end
end
subgraph 192.168.1.xxx
subgraph MCPClient [MCP Client]
end
end
EagleApp ==> MCPServer e1@==> MCPClient
MCPClient e2@==> MCPServer ==> EagleApp
EagleApp ==> FileSystem
FileSystem ==> EagleApp
e1@{ animate: true }
e2@{ animate: true }[!警告] ファイルシステムにアクセスできません。
3) その他のホスト
flowchart LR
subgraph 192.168.1.100
subgraph FileSystem [File System]
end
subgraph EagleApp [Eagle App<br/>localhost:41595]
end
end
subgraph 192.168.1.101
subgraph MCPServer [MCP Server<br/>localhost:8000]
end
end
subgraph 192.168.1.xxx
subgraph MCPClient [MCP Client]
end
end
EagleApp ==> MCPServer e1@==> MCPClient
MCPClient e2@==> MCPServer ==> EagleApp
EagleApp ==> FileSystem
FileSystem ==> EagleApp
e1@{ animate: true }
e2@{ animate: true }[!警告] ファイルシステムにアクセスできません。