eagle-mcp-server

🚀 翔鹰 MCP 服务器（非官方）

本项目是为翔鹰（Eagle）设计的模型上下文协议（MCP）服务器，可通过网络与翔鹰应用程序交互，支持多种文件格式的传输和操作，为用户提供便捷的模型上下文服务。

🚀 快速开始

翔鹰 MCP 服务器是一个非官方实现，旨在为翔鹰（Eagle）提供模型上下文协议（MCP）服务。该服务器允许通过网络与翔鹰应用程序交互，并支持多种文件格式的传输和操作。

✨ 主要特性

• 支持多种常见文件格式，如图片、视频、音频、3D模型等。
• 可通过网络与翔鹰应用程序进行交互。
• 提供多种工具功能，如启动/停止服务器、文件上传/下载、项目同步、日志查看等。

📦 安装指南

依赖项

• Python
• uvicorn：用于运行服务器
• python-multipart：用于处理文件上传
• 确保翔鹰应用程序已安装并运行在本地或远程主机上。

安装步骤

1. 安装依赖项：

pip install uvicorn python-multipart

2. 启动服务器：

uvicorn main:app --reload

3. 访问翔鹰 MCP 服务器的文档页面：

打开浏览器访问 http://localhost:8000/docs 或 http://localhost:8000/redoc

💻 使用示例

连接方式

要将翔鹰 MCP 服务器与客户端连接，可以通过以下配置：

在同一主机上（翔鹰应用程序、MCP 服务器和文件系统在同一设备）

# 示例配置：在客户端中访问翔鹰 MCP 服务
http://localhost:8000

在同一网络的不同主机上（翔鹰应用程序和 MCP 服务器在同一局域网内）

# 示例配置：在客户端中访问翔鹰 MCP 服务
http://[MCP服务器IP]:8000

📚 详细文档

工具列表

下表列出了与翔鹰 MCP 服务器相关的工具及其功能：

| 属性 | 详情 | |------|------| | 启动服务器 | 启动翔鹰 MCP 服务器 | | 停止服务器 | 关闭翔鹰 MCP 服务器 | | 文件上传 | 将文件传输到翔鹰项目中 | | 文件下载 | 从翔鹰项目中下载文件 | | 项目同步 | 同步翔鹰项目的本地和远程数据 | | 日志查看 | 查看翔鹰 MCP 服务器的日志 |

注意事项

在同一主机上（翔鹰应用程序、MCP 服务器和文件系统在同一设备）

flowchart LR
  
    subgraph 192.168.1.100
        subgraph FileSystem [文件系统]
        end
        subgraph EagleApp [翔鹰应用程序<br/>localhost:41595]
        end
        subgraph MCPServer [MCP 服务器<br/>localhost:8000]
        end
        subgraph MCPClient [MCP 客户端]
        end
    end

    EagleApp ==> MCPServer e1@==> MCPClient
    MCPClient e2@==> MCPServer ==> EagleApp
    EagleApp ==> FileSystem
    FileSystem ==> EagleApp

    e1@{ animate: true }
    e2@{ animate: true }

⚠️ 重要提示

您可以直接访问文件系统。

在同一主机上（翔鹰应用程序、MCP 服务器）+ 其他主机（MCP 客户端）

flowchart LR
  
    subgraph 192.168.1.100
        subgraph FileSystem [文件系统]
        end
        subgraph EagleApp [翔鹰应用程序<br/>localhost:41595]
        end
        subgraph MCPServer [MCP 服务器<br/>localhost:8000]
        end
    end

    subgraph 192.168.1.xxx
        subgraph MCPClient [MCP 客户端]
        end
    end

    EagleApp ==> MCPServer e1@==> MCPClient
    MCPClient e2@==> MCPServer ==> EagleApp
    EagleApp ==> FileSystem
    FileSystem ==> EagleApp

    e1@{ animate: true }
    e2@{ animate: true }

⚠️ 重要提示

您没有文件系统的访问权限。

在其他主机上（翔鹰应用程序和 MCP 服务器位于不同设备）

flowchart LR

    subgraph 192.168.1.100
        subgraph FileSystem [文件系统]
        end
        subgraph EagleApp [翔鹰应用程序<br/>localhost:41595]
        end
    end

    subgraph 192.168.1.101
        subgraph MCPServer [MCP 服务器<br/>localhost:8000]
        end
    end

    subgraph 192.168.1.xxx
        subgraph MCPClient [MCP 客户端]
        end
    end

    EagleApp ==> MCPServer e1@==> MCPClient
    MCPClient e2@==> MCPServer ==> EagleApp
    EagleApp ==> FileSystem
    FileSystem ==> EagleApp

    e1@{ animate: true }
    e2@{ animate: true }

⚠️ 重要提示

您没有文件系统的访问权限。