Eagle MCP Server (Unofficial)

Eagle MCP サーバー（非公式）

メモ

Eagle v5 では公式 MCP サポートが予定されています（2026 年第 1 四半期にパブリックベータ版を公開予定）

Eagle 用の Model Context Protocol（MCP）サーバーです。

• Eagle：https://eagle.cool/
  
• Eagle API ドキュメント：https://api.eagle.cool/
  

要件

• Python 3.13
• uv

前提条件

必要な依存関係をインストールします：

uv sync

使用方法

1. Eagle アプリを起動します。
2. 次のコマンドを実行して、この MCP サーバーを起動します：

uv run main.py

Streamable HTTP を使用した MCP サーバーへの接続

MCP 設定：

{
  "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"
      ]
    }
  }
}

ツール

MCP サーバー API ドキュメント：

• https://tuki0918.github.io/eagle-mcp-server/
• http://localhost:8000/redoc

無効なツールを有効にする

一部のツールはデフォルトで無効になっています（上記の「有効（デフォルト）」列が空欄のツール）。これらのツールを有効にするには：

1. ソースコード内でツールの定義を探します
2. ツール設定から tags=["Disabled"] の行を削除します
3. MCP サーバーを再起動します

これにより、以前は無効だったツールが使用可能になります。

ユースケース

1) 同じホスト（推奨）

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) 別のホスト（MCP クライアント）＋同じホスト（MCP サーバー、Eagle アプリ）

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) 別のホスト

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 }

警告

ファイルシステムにアクセスできません。