Skip to main content
Glama
enesjakozh
tuki0918

Eagle MCP Server

by tuki0918
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Eagle MCP Server (Unofficial)

NOTE

Official MCP support is planned for Eagle v5 (public beta in Q1 2026)

A Model Context Protocol (MCP) server for Eagle.

  • JPG / JPEG

  • PNG

  • PDF

  • SVG

  • MP4

  • MP3

  • FBX

  • OBJ

  • EPS

  • TIF / TIFF

  • WebP

  • BMP

  • ICO

  • RAW

  • etc

Requirements

  • Python 3.13

  • uv

Related MCP server: files-mcp-ts

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

MCP config:

{
  "mcpServers": {
    "eagle-mcp-server": {
      "url": "http://localhost:8000/mcp"
    }
  }
}
{
  "mcpServers": {
    "eagle-mcp-server": {
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/tuki0918/eagle-mcp-server@fastmcp-stdio",
        "eagle-mcp-server"
      ]
    }
  }
}

See #17 for more details.

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

1) Same Host (Recommended)

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 }
TIP

You have direct access to the filesystem.

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 }
WARNING

You don't have access to the filesystem.

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 }
WARNING

You don't have access to the filesystem.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • files-mcp-ts

    LiviuBirjega
    F
    license
    B
    quality
    D
    maintenance
    A lightweight MCP server for basic file operations, enabling reading, writing, and listing files securely via the Model Context Protocol.
    3
    1
    -

  • fsext-mcp-server-python

    kurtzhi
    A
    license
    C
    quality
    B
    maintenance
    A full-featured secure MCP server for local file system operations, with built-in image processing, OCR and media tools. Fully compliant with the official Model Context Protocol specification, offering standardized request/response schemas, large-file streaming I/O, multi-transport remote deployment, and comprehensive text search & replace functionality for LLM agent integration.
    22
    Apache 2.0

  • lazy-media-mcp

    leaf76
    A
    license
    A
    quality
    C
    maintenance
    Local MCP server that compresses images and videos, extracts video frames, and prepares media for AI vision agents by returning file paths instead of inline base64.
    6
    5 npm
    1
    MIT