AI导哈

Eagle MCP 服务器

Eagle MCP 服务器是一个为Eagle设计的模型上下文协议服务器，支持多种文件格式的管理和操作。

  • by tuki0918
  • Python
  • 混合部署
  • 19 星标
  • 更新于
在 GitHub 查看 tuki0918/eagle-mcp-server

使用说明

Eagle MCP服务器（非官方）

[！注意] Eagle v5（2026年第一季度公测版）计划获得MCP官方支持

一种模型上下文协议（MCP）服务器 鹰.

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

需求

先决条件

安装所需的依赖项：

uv sync

用法

  1. 启动 鹰 应用程序。
  2. 通过运行以下命令启动此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

启用禁用的工具

默认情况下，某些工具被禁用（在上面的“启用（默认）”列中显示为空单元格）。要启用这些禁用的工具，请执行以下操作：

  1. 在源代码中找到工具定义
  2. 移除 tags=["Disabled"] 刀具配置中的线条
  3. 重新启动MCP服务器

这将使以前禁用的工具可供使用。

用例

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

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 }

[！警告] 您无权访问文件系统。

相关 MCP