Eagle MCP Server (Unofficial)

@tuki0918

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

tuki0918

关于 Eagle MCP Server

[MCP] A Model Context Protocol (MCP) server for Eagle. Manages local media files (e.g., images, mp3, mp4)

#filesystem#eagle#mcp-server

Eagle MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "eagle-mcp-server": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Eagle MCP Server 工具

http://localhost:8000/redoc

概览

What is Eagle MCP Server (Unofficial)?

An unofficial Model Context Protocol (MCP) server for the Eagle digital asset management app. It exposes Eagle’s local API through MCP tools, enabling AI assistants to interact with folders, items, libraries, and application settings. Designed for users who want to automate or extend Eagle workflows via MCP-compatible clients.

How to use Eagle MCP Server (Unofficial)?

Install dependencies with uv sync (Python 3.13 and uv required).
Launch the Eagle app.
Run the server: uv run main.py.
In your MCP client, configure a server with URL http://localhost:8000/mcp (Streamable HTTP). For stdio transport, use the alternative configuration with uvx and the fastmcp-stdio branch.

Key features of Eagle MCP Server (Unofficial)

20+ tools covering folders, items, libraries, and application info.
Add items from URL, file path, or create bookmarks.
Create, rename, update, and list folders.
Retrieve item details, thumbnails, and color palettes.
Move items to trash, update metadata, and refresh thumbnails.
Some tools are disabled by default (can be enabled by editing source).

Use cases of Eagle MCP Server (Unofficial)

Automate asset ingestion by adding items from URLs or local paths via AI agents.
Organize libraries programmatically: create folders, rename, or update folder properties.
Query Eagle metadata (application info, library history) without leaving your MCP client.
Build AI‑powered workflows that search, tag, or move assets inside Eagle.
Run the server on the same host as Eagle for full filesystem access, or on a separate host for remote control.

常见问题

Is this the official Eagle MCP support?

No – this is an unofficial server. Official MCP support is planned for Eagle v5 (public beta in Q1 2026).

What are the runtime requirements?

Python 3.13 and the `uv` package manager. The server also requires the Eagle desktop app to be running locally.

Which file formats does Eagle MCP Server support?

It supports JPG/JPEG, PNG, PDF, SVG, MP4, MP3, FBX, OBJ, EPS, TIF/TIFF, WebP, BMP, ICO, RAW, and others.

How do I enable disabled tools?

Some tools are disabled by default. Locate the tool definition in the source code, remove the `tags=["Disabled"]` line, and restart the server.

What transport protocols are available?

Streamable HTTP (default, URL `http://localhost:8000/mcp`) and stdio (alternative config using `uvx` and a `fastmcp-stdio` branch).

其他分类下的更多 MCP 服务器

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context