Eagle MCP 服务器（非官方）
Eagle 的模型上下文协议 (MCP) 服务器。维基百科
要求
先决条件
安装所需的依赖项：
用法
启动Eagle应用程序。
通过运行以下命令启动此 MCP 服务器：
uv run main.py
# To use a different endpoint:
# EAGLE_API_BASE_URL=http://localhost:12345 uv run main.py
使用 SSE 连接到 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 端点 | 已启用（默认） | 类别 |
✅ | connect
| /api/连接 | | 微胶囊钙 |
✅ | get_application_info
| /api/应用程序/信息 | ⚫︎ | 应用 |
✅ | create_folder
| /api/文件夹/创建 | ⚫︎ | 文件夹 |
✅ | rename_folder
| /api/文件夹/重命名 | | 文件夹 |
✅ | update_folder
| /api/文件夹/更新 | ⚫︎ | 文件夹 |
✅ | get_folder_list
| /api/文件夹/列表 | ⚫︎ | 文件夹 |
✅ | get_folder_list_recent
| /api/folder/listRecent | | 文件夹 |
✅ | add_item_from_url
| /api/item/addFromURL | | 物品 |
✅ | add_items_from_urls
| /api/item/addFromURLs | | 物品 |
✅ | add_item_from_path
| /api/item/addFromPath | ⚫︎ | 物品 |
✅ | add_items_from_paths
| /api/item/addFromPaths | | 物品 |
✅ | add_bookmark
| /api/item/addBookmark | | 物品 |
✅ | get_item_info
| /api/item/info | ⚫︎ | 物品 |
✅ | get_item_source
| /api/item/source | ⚫︎ | 物品 |
✅ | get_item_thumbnail
| /api/item/缩略图 | | 物品 |
✅ | get_item_list
| /api/item/list | ⚫︎ | 物品 |
✅ | move_item_to_trash
| /api/item/moveToTrash | ⚫︎ | 物品 |
✅ | refresh_item_palette
| /api/item/refreshPalette | | 物品 |
✅ | refresh_item_thumbnail
| /api/item/refreshThumbnail | | 物品 |
✅ | update_item
| /api/item/更新 | ⚫︎ | 物品 |
✅ | get_library_info
| /api/library/info | ⚫︎ | 图书馆 |
✅ | get_library_history
| /api/library/history | | 图书馆 |
✅ | switch_library
| /api/library/switch | | 图书馆 |
✅ | get_library_icon
| /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 }