Eagle MCP Server (Unofficial)

Name: Eagle MCP Server (Unofficial)
Author: tuki0918

本地服务

github.com/tuki0918媒体与设计1942 周前更新

代码仓库

关于 Eagle MCP Server (Unofficial)

Eagle MCP Server 是面向 Eagle 素材管理应用的非官方 MCP 服务，用于管理本地图片、音频、视频等媒体文件。它通过 Streamable HTTP 或 stdio 提供接口，适合需要让 AI 客户端操作 Eagle 资源库的用户。

主要功能

01支持图片、音频、视频、3D 模型等多种格式
02提供文件夹、素材、资源库的读写工具
03可通过 HTTP 或 stdio 传输连接
04部分工具默认关闭，可在源码中启用

适用场景

01让 AI 客户端检索并查看 Eagle 资源库中的素材
02通过 MCP 工具批量导入本地文件或网址素材
03在 Eagle 中整理文件夹和标签信息

MCP 相关

该项目是 MCP 服务，将 Eagle 的 API 能力以工具形式暴露给 MCP 客户端，例如查询素材信息、添加文件和管理文件夹。

#filesystem #eagle #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Eagle MCP 服务（非官方）

说明

Eagle v5 计划提供官方 MCP 支持（2026 年第一季度公开测试版）

README 配图

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

支持的文件格式：

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

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

要求

Python 3.13
uv

前置条件

安装所需的依赖项：

uv sync

使用方法

启动 Eagle 应用。
运行以下命令启动此 MCP 服务：

uv run main.py

使用 Streamable HTTP 连接到 MCP 服务

MCP 配置：

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

如果需要使用 stdio 传输：

{
  "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/application/info	`get_application_info`	⚫︎	应用程序
✅	/api/folder/create	`create_folder`	⚫︎	文件夹
✅	/api/folder/rename	`rename_folder`		文件夹
✅	/api/folder/update	`update_folder`	⚫︎	文件夹
✅	/api/folder/list	`get_folder_list`	⚫︎	文件夹
✅	/api/folder/listRecent	`get_folder_list_recent`		文件夹
✅	/api/item/addFromURL	`add_item_from_url`		项目
✅	/api/item/addFromURLs	`add_items_from_urls`		项目
✅	/api/item/addFromPath	`add_item_from_path`	⚫︎	项目
✅	/api/item/addFromPaths	`add_items_from_paths`		项目
✅	/api/item/addBookmark	`add_bookmark`		项目
✅	/api/item/info	`get_item_info`	⚫︎	项目
✅	-	`get_item_source`	⚫︎	项目
✅	/api/item/thumbnail	`get_item_thumbnail`		项目
✅	/api/item/list	`get_item_list`	⚫︎	项目
✅	/api/item/moveToTrash	`move_item_to_trash`	⚫︎	项目
✅	/api/item/refreshPalette	`refresh_item_palette`		项目
✅	/api/item/refreshThumbnail	`refresh_item_thumbnail`		项目
✅	/api/item/update	`update_item`	⚫︎	项目
✅	/api/library/info	`get_library_info`	⚫︎	资源库
✅	/api/library/history	`get_library_history`		资源库
✅	/api/library/switch	`switch_library`		资源库
✅	/api/library/icon	`get_library_icon`		资源库

MCP 服务 API 文档：

启用已禁用的工具

某些工具默认处于禁用状态（如上方“已启用（默认）”列中的空单元格所示）。要启用这些工具：

在源代码中找到工具定义
从工具配置中删除 tags=["Disabled"] 这一行
重启 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 }

警告

你无法访问文件系统。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。