Eagle MCP服务器(非官方)
\[!注意\] Eagle v5(2026年第一季度公测版)计划获得MCP官方支持

一种模型上下文协议(MCP)服务器 鹰.
Supported file formats:
JPG/JPEGPNGPDFSVGMP4MP3FBXOBJEPSTIF/TIFFWebPBMPICORAW- 等等
- Eagle API文件:https://api.eagle.cool/
需求
- Python 3.13
- 紫外线
先决条件
安装所需的依赖项:
uv sync用法
- 启动 鹰 应用程序。
- 通过运行以下命令启动此MCP服务器:
uv run main.py使用流式HTTP连接到MCP服务器
MCP配置:
{
"mcpServers": {
"eagle-mcp-server": {
"url": "http://localhost:8000/mcp"
}
}
}If you need stdio transport instead:
{
"mcpServers": {
"eagle-mcp-server": {
"command": "uvx",
"args": [
"--from", "git+https://github.com/tuki0918/eagle-mcp-server@fastmcp-stdio",
"eagle-mcp-server"
]
}
}
}看 #17 了解更多详情。
工具
| 支持 | Eagle API端点 | 操作ID | 已启用(默认) | 类别 |
|---|---|---|---|---|
| ✅ | - | connect | MCP | |
| ✅ | /api/应用程序/信息 | get_application_info | ⚫︎ | 应用程序 |
| ✅ | /api/文件夹/创建 | create_folder | ⚫︎ | 文件夹 |
| ✅ | /api/文件夹/重命名 | rename_folder | 文件夹 | |
| ✅ | /api/文件夹/更新 | update_folder | ⚫︎ | 文件夹 |
| ✅ | /api/文件夹/列表 | get_folder_list | ⚫︎ | 文件夹 |
| ✅ | /api/文件夹/list最近 | get_folder_list_recent | 文件夹 | |
| ✅ | /api/item/addFromURL | add_item_from_url | 项目 | |
| ✅ | /api/item/addFromURL | add_items_from_urls | 项目 | |
| ✅ | /api/item/addFromPath | add_item_from_path | ⚫︎ | 项目 |
| ✅ | /api/item/addFromPaths | add_items_from_paths | 项目 | |
| ✅ | /API/item/addbookmark | add_bookmark | 项目 | |
| ✅ | /api/项目/信息 | get_item_info | ⚫︎ | 项目 |
| ✅ | - | get_item_source | ⚫︎ | 项目 |
| ✅ | /api/项目/缩略图 | get_item_thumbnail | 项目 | |
| ✅ | /api/项目/列表 | get_item_list | ⚫︎ | 项目 |
| ✅ | /api/item/moveToTrash | move_item_to_trash | ⚫︎ | 项目 |
| ✅ | /API/项目/刷新 | refresh_item_palette | 项目 | |
| ✅ | /API/项目/刷新缩略图 | refresh_item_thumbnail | 项目 | |
| ✅ | /api/项目/更新 | update_item | ⚫︎ | 项目 |
| ✅ | /api/库/信息 | get_library_info | ⚫︎ | 图书馆 |
| ✅ | /api/库/历史 | get_library_history | 图书馆 | |
| ✅ | /api/库/开关 | switch_library | 图书馆 | |
| ✅ | /api/库/图标 | get_library_icon | 图书馆 |
MCP服务器API文档:
- https://tuki0918.github.io/eagle-mcp-server/
- http://localhost:8000/redoc
启用禁用的工具
默认情况下,某些工具被禁用(在上面的“启用(默认)”列中显示为空单元格)。要启用这些禁用的工具,请执行以下操作:
- 在源代码中找到工具定义
- 移除
tags=["Disabled"]刀具配置中的线条 - 重新启动MCP服务器
这将使以前禁用的工具可供使用。
用例
1) 同一主机(推荐)
flowchart LR
subgraph 192.168.1.100
direction LR
subgraph FileSystem [File System]
end
subgraph EagleApp [Eagle App
localhost:41595]
end
subgraph MCPServer [MCP Server
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) 其他主机(MCP客户端)+同一主机(MCP服务器、Eagle应用程序)
flowchart LR
subgraph 192.168.1.100
subgraph FileSystem [File System]
end
subgraph EagleApp [Eagle App
localhost:41595]
end
subgraph MCPServer [MCP Server
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
localhost:41595]
end
end
subgraph 192.168.1.101
subgraph MCPServer [MCP Server
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 }\[!警告\] 您无权访问文件系统。
