MCPgee
MCPgee
MCPgeeMCPgee

Eagle

v1.0.0•File Systems•stable

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

eaglefilesystemmcp-server
Share:
17
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Eagle?

Eagle is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to [mcp] a model context protocol (mcp) server for eagle. manages local media files (e.g., images, mp3, mp4)

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

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP protocol support

Use Cases

Local media file management
Image, audio, video organization
tuki0918

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx eagle

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Eagle

Eagle MCP Server is a Python-based Model Context Protocol server that bridges AI assistants with the Eagle media management application, enabling programmatic control over your local media library. It exposes over 25 MCP tools covering folder management, item operations, library switching, and metadata updates for files including images, audio, video, PDFs, SVGs, and 3D models. Designers and creative professionals use it to let AI assistants organize, tag, search, and manage their Eagle libraries through natural language.

Prerequisites

  • Python 3.13 installed
  • The uv package manager installed (https://github.com/astral-sh/uv)
  • Eagle application installed and running on your machine (eagle.cool)
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Clone the repository

Clone the Eagle MCP server source from GitHub to your local machine.

git clone https://github.com/tuki0918/eagle-mcp-server.git
cd eagle-mcp-server
2

Install dependencies with uv

Use uv to sync and install all Python dependencies defined in the project's pyproject.toml into a managed virtual environment.

uv sync
3

Start the Eagle application

Launch the Eagle desktop application before starting the MCP server, as the server communicates with Eagle's local API. Eagle must be running on its default port for tool calls to succeed.

4

Run the MCP server

Start the server using uv run. By default it binds to http://localhost:8000/mcp and serves the MCP protocol over HTTP transport.

uv run main.py
5

Configure your MCP client

Add the Eagle MCP server to your client configuration. The recommended approach is HTTP transport pointing to the local server URL.

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

Explore available tools

The server exposes tools across four categories: Application info, Folder operations (create, rename, update, list), Item operations (add from URL or path, get info, thumbnails, move to trash, update metadata), and Library operations (get info, history, switch, icons). Some tools are disabled by default and can be enabled by removing the tags=["Disabled"] annotation in the source code.

Eagle Examples

Client configuration

Add this to your claude_desktop_config.json for HTTP transport to the locally running Eagle MCP server.

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

Prompts to try

After starting Eagle and the MCP server, try these prompts in your AI client.

- "Create a new folder called 'Brand Assets 2024' in my Eagle library"
- "Add the image at /Users/me/Downloads/logo.png to Eagle with tags brand, logo"
- "List all folders in my current Eagle library"
- "Get the thumbnail for item ID abc123 in Eagle"
- "Move item xyz789 to trash in Eagle"

Troubleshooting Eagle

Tools return connection refused or Eagle API errors

Make sure the Eagle desktop application is running before starting the MCP server. Eagle exposes a local REST API that the server proxies — without Eagle running, all tool calls will fail.

uv sync fails with Python version error

This project requires Python 3.13 exactly. Run `uv python install 3.13` to install the correct version, then retry `uv sync`. Check your active Python version with `uv python list`.

Some tools are missing from the MCP tool list

Certain tools are disabled by default in the source. Open the relevant source file and remove the `tags=["Disabled"]` argument from the @tool decorator to enable them, then restart the server.

Frequently Asked Questions about Eagle

What is Eagle?

Eagle is a Model Context Protocol (MCP) server that [mcp] a model context protocol (mcp) server for eagle. manages local media files (e.g., images, mp3, mp4) It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Eagle?

Follow the installation instructions on the Eagle GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Eagle?

Eagle works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Eagle free to use?

Yes, Eagle is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Eagle Alternatives — Similar File Systems Servers

Looking for alternatives to Eagle? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.

Electerm

★ 14.1k

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

Plik

★ 1.8k

Plik is a temporary file upload system (Wetransfer like) in Go.

Kordoc

★ 957

An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.

macOS Automator

★ 801

A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.

PDF Reader

★ 723

Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.

Filesystem MCP Server

★ 643

Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

File SystemsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "eagle": { "command": "npx", "args": ["-y", "eagle"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Eagle?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides