Eagle MCP Server (Unofficial)

Name: Eagle MCP Server (Unofficial)
Author: tuki0918

@tuki0918

リポジトリ

Eagle MCP Server (Unofficial) について

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

#filesystem #eagle #mcp-server

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

tuki0918

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

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.