t
tuki0918
@tuki0918/eagle-mcp-server
0 Stars
337 次浏览
tuki0918
更新于 2026-08-23
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"eagle-mcp-server": {
"url": "http://localhost:8000/mcp"
}
}
}服务介绍
Eagle MCP 服务器（非官方）
一个用于 Eagle 的模型上下文协议 (MCP) 服务器。Wiki
JPG/JPEGPNGPDFSVGMP4MP3FBXOBJEPSTIF/TIFFWebPBMPICORAW- 等等
- Eagle: https://eagle.cool/
- Eagle API 文档: https://api.eagle.cool/
要求
- Python 3.13
- uv
前提条件
安装所需的依赖项：
bash
uv sync
使用方法
- 启动 Eagle 应用程序。
- 通过运行以下命令启动此 MCP 服务器：
bash
uv run main.py
若要使用不同的端点：
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 Code
"mcp": {
"servers": {
"eagle-mcp-server": {
"type": "sse",
"url": "http://localhost:8000/mcp"
}
}
}
工具
| 支持 | 操作 ID | API 端点 | 默认启用 | 类别 |
|---|---|---|---|---|
| ✅ | connect |
/api/connect | MCP | |
| ✅ | get_application_info |
/api/application/info | ⚫︎ | Application |
| ✅ | create_folder |
/api/folder/create | ⚫︎ | Folder |
| ✅ | rename_folder |
/api/folder/rename | Folder | |
| ✅ | update_folder |
/api/folder/update | ⚫︎ | Folder |
| ✅ | get_folder_list |
/api/folder/list | ⚫︎ | Folder |
| ✅ | get_folder_list_recent |
/api/folder/listRecent | Folder | |
| ✅ | add_item_from_url |
/api/item/addFromURL | Item | |
| ✅ | add_items_from_urls |
/api/item/addFromURLs | Item | |
| ✅ | add_item_from_path |
/api/item/addFromPath | ⚫︎ | Item |
| ✅ | add_items_from_paths |
/api/item/addFromPaths | Item | |
| ✅ | add_bookmark |
/api/item/addBookmark | Item | |
| ✅ | get_item_info |
/api/item/info | ⚫︎ | Item |
| ✅ | get_item_source |
/api/item/source | ⚫︎ | Item |
| ✅ | get_item_thumbnail |
/api/item/thumbnail | Item | |
| ✅ | get_item_list |
/api/item/list | ⚫︎ | Item |
| ✅ | move_item_to_trash |
/api/item/moveToTrash | ⚫︎ | Item |
| ✅ | refresh_item_palette |
/api/item/refreshPalette | Item | |
| ✅ | refresh_item_thumbnail |
/api/item/refreshThumbnail | Item | |
| ✅ | update_item |
/api/item/update | ⚫︎ | Item |
| ✅ | get_library_info |
/api/library/info | ⚫︎ | Library |
| ✅ | get_library_history |
/api/library/history | Library | |
| ✅ | switch_library |
/api/library/switch | Library | |
| ✅ | get_library_icon |
/api/library/icon | Library | |
| [ ] | ... | ... | ... |
MCP 服务器 API 文档:
- https://tuki0918.github.io/eagle-mcp-server/
- http://localhost:8000/redoc
使用案例
1) 同一主机（推荐）
mermaid
flowchart LR
subgraph 192.168.1.100
direction LR
subgraph FileSystem [文件系统]
end
subgraph EagleApp [Eagle 应用<br/>localhost:41595]
end
subgraph MCPServer [MCP 服务器<br/>localhost:8000]
end
subgraph MCPClient [MCP 客户端]
end
end
EagleApp ==> MCPServer e1@==> MCPClient
MCPClient e2@==> MCPServer ==> EagleApp
EagleApp ==> FileSystem
FileSystem ==> EagleApp
e1@{ animate: true }
e2@{ animate: true }> [!TIP]
您可以直接访问文件系统。
2) 同一主机（Eagle 应用程序，MCP 服务器）+ 其他主机（MCP 客户端）
mermaid
flowchart LR
subgraph 192.168.1.100
subgraph FileSystem [文件系统]
end
subgraph EagleApp [Eagle 应用程序<br/>localhost:41595]
end
subgraph MCPServer [MCP 服务器<br/>localhost:8000]
end
end
subgraph 192.168.1.xxx
subgraph MCPClient [MCP 客户端]
end
end
EagleApp ==> MCPServer e1@==> MCPClient
MCPClient e2@==> MCPServer ==> EagleApp
EagleApp ==> FileSystem
FileSystem ==> EagleApp
e1@{ animate: true }
e2@{ animate: true }
[!WARNING]
您无法访问文件系统。
3) 其他主机
mermaid
flowchart LR
subgraph 192.168.1.100
subgraph FileSystem [文件系统]
end
subgraph EagleApp [Eagle 应用程序<br/>localhost:41595]
end
end
subgraph 192.168.1.101
subgraph MCPServer [MCP 服务器<br/>localhost:8000]
end
end
subgraph 192.168.1.xxx
subgraph MCPClient [MCP 客户端]
end
end
EagleApp ==> MCPServer e1@==> MCPClient
MCPClient e2@==> MCPServer ==> EagleApp
EagleApp ==> FileSystem
FileSystem ==> EagleApp
e1@{ animate: true }
e2@{ animate: true }
[!WARNING]
您无法访问文件系统。
