Skip to main content

Eagle MCP Server (Unofficial)

A Model Context Protocol (MCP) server for Eagle.

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

Requirements

  • Python 3.13
  • uv

Prerequisites

Install the required dependencies:

uv sync

Usage

  1. Launch the Eagle app.
  2. Launch this MCP server by running the following command:
uv run main.py

Connecting to the MCP Server using Streamable HTTP

Example config (Cursor editor recommended):

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

Tools

Supported Eagle API endpoint Operation ID Enabled (default) Category
✅ - 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 Server API docs:

Enabling Disabled Tools

Some tools are disabled by default (shown as empty cells in the "Enabled (default)" column above). To enable these disabled tools:

  1. Locate the tool definition in the source code
  2. Remove the tags=["Disabled"] line from the tool configuration
  3. Restart the MCP server

This will make the previously disabled tools available for use.

Use Cases

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) Other Host (MCP Client) + Same Host (MCP Server, Eagle App)

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) Other Host

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 }

Metadata

Release files for iflow-mcp_tuki0918-eagle-mcp-server 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_tuki0918-eagle-mcp-server 0.1.0
File Size Uploaded Provenance Actions
iflow_mcp_tuki0918_eagle_mcp_server-0.1.0.tar.gz 341.5 kB Without provenance Details for iflow_mcp_tuki0918_eagle_mcp_server-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_tuki0918-eagle-mcp-server 0.1.0
File Interpreter ABI Platform Actions
iflow_mcp_tuki0918_eagle_mcp_server-0.1.0-py3-none-any.whl Python 3 none any Details for iflow_mcp_tuki0918_eagle_mcp_server-0.1.0-py3-none-any.whl

Total release size: 353.2 kB

Release files / iflow_mcp_tuki0918_eagle_mcp_server-0.1.0.tar.gz

Download URL iflow_mcp_tuki0918_eagle_mcp_server-0.1.0.tar.gz
Size 341.5 kB
Tags Source
SHA-256 checksum
How to use checksums
1d27972f681c24f4fe0102c6b6caa3ce2a5ea0f91c0f5ebee70087af02b91e99
BLAKE2b-256 checksum
How to use checksums
9ada2e135388aff695a0ab15fb7a708d8d7e1ac19f7b21a84c19aafeeb6fad20
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_tuki0918_eagle_mcp_server-0.1.0-py3-none-any.whl

Download URL iflow_mcp_tuki0918_eagle_mcp_server-0.1.0-py3-none-any.whl
Size 11.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6e62656708d9094d12e49bbb1bb8e4219f5a279605392da02ad40fc0644158dc
BLAKE2b-256 checksum
How to use checksums
482be8550d19446ccf9ac0984ad3b07031d76df3dc5844c5233e37bdbd82d271
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for iflow-mcp_tuki0918-eagle-mcp-server 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page