Eagle MCP Server（非官方）

[!NOTE] Eagle v5（计划于2026年第一季度公开测试版）将支持官方MCP

适用于Eagle的模型上下文协议（MCP）服务器。

<details> <summary>支持的文件格式：</summary>

• JPG / JPEG
• PNG
• PDF
• SVG
• MP4
• MP3
• FBX
• OBJ
• EPS
• TIF / TIFF
• WebP
• BMP
• ICO
• RAW
• 等等

</details>

• Eagle: https://eagle.cool/
• Eagle API 文档: https://api.eagle.cool/

要求

• Python 3.13
• uv

预备条件

安装所需的依赖项：

uv sync

使用方法

1. 启动 Eagle 应用程序。
2. 运行以下命令启动此MCP服务器：

uv run main.py

使用Streamable HTTP连接到MCP服务器

MCP配置：

{
  "mcpServers": {
    "eagle-mcp-server": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

<details> <summary>如果需要使用stdio传输：</summary>

{
  "mcpServers": {
    "eagle-m-服务器": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/tuki0918/eagle-mcp-server@fastmcp-stdio",
        "eagle-mcp-server"
      ]
    }
  }
}

详情参见#17。

</details>

工具

支持	Eagle API端点	操作ID	默认启用	类别
✅	-	connect		MCP
✅	/api/application/info	get_application_info	⚫︎	Application
✅	/api/folder/create	create_folder	⚫︎	Folder
✅	/api/folder/rename	rename_folder		Folder
✅	/api/folder/update	update_folder	⚫︎	Folder
✅	/api/folder/list	get_folder_list	⚫︎	Folder
✅	/api/folder/listRecent	get_folder_list_recent		Folder
✅	/api/item/addFromURL	add_item_from_url		Item
✅	/api/item/addFromURLs	add_items_from_urls		Item
✅	/api/item/addFromPath	add_item_from_path	⚫︎	Item
✅	/api/item/addFromPaths	add_items_from_paths		Item
✅	/api/item/addBookmark	add_bookmark		Item
✅	/api/item/info	get_item_info	⚫︎	Item
✅	-	get_item_source	⚫︎	Item
✅	/api/item/thumbnail	get_item_thumbnail		Item
✅	/api/item/list	get_item_list	⚫︎	Item
✅	/api/item/moveToTrash	move_item_to_trash	⚫︎	Item
✅	/api/item/refreshPalette	refresh_item_palette		Item
✅	/api/item/refreshThumbnail	refresh_item_thumbnail		Item
✅	/api/item/update	update_item	⚫︎	Item
✅	/api/library/info	get_library_info	⚫︎	Library
✅	/api/library/history	get_library_history		Library
✅	/api/library/switch	switch_library		Library
✅	/api/library/icon	get_library_icon		Library

MCP服务器API文档：

• https://tuki0918.github.io/eagle-mcp-server/
• http://localhost:8000/redoc

启用禁用的工具

某些工具默认是禁用的（在“默认启用”列中显示为空白单元格）。要启用这些禁用的工具：

1. 在源代码中找到工具定义。
2. 从工具配置中移除 tags=["Disabled"] 行。
3. 重启MCP服务器。

这将使之前禁用的工具可用。

使用场景

1) 同一主机（推荐）

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) 其他主机（MCP客户端）+ 同一主机（MCP服务器，Eagle应用）

flowchart LR
  
    subgraph 1192.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) 其他主机

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] 您无法访问文件系统。