Leonardo MCP Server

🚀 Leonardo MCP Server

Leonardo MCP Server 是一个为 Leonardo AI 打造的模型上下文协议（MCP）服务器，支持 HTTP 和 stdio 两种模式。它能帮助用户与 Leonardo AI 进行交互，实现图像生成等功能。

✨ 主要特性

• 利用 Leonardo AI 创建图像生成任务。
• 查看可用模型。
• 检查图像生成任务的状态。
• 获取用户的所有图像生成任务。
• 同时支持 HTTP 和 stdio 传输方式。

📦 安装指南

JSON 配置

支持 Claude Desktop、Cursor 等使用 JSON 配置文件的 MCP 客户端。

⚠️ 重要提示

在运行服务器之前，你需要生成一个 Leonardo API 密钥，并将其设置为环境变量 LEONARDO_API_KEY。

{
  "mcpServers": {
    "leonardo-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/ish-joshi/leonardo-mcp-server",
        "leonardo-mcp-server",
        "stdio"
      ],
      "env": {
        "LEONARDO_API_KEY": "YOUR_LEONARDO_API_KEY"
      }
    }
  }
}

💻 使用示例

演示

点击下面的图片观看演示视频：

运行模式

本服务器支持两种运行模式：

• HTTP 模式（默认）：
  • 适用于远程客户端（例如 ChatGPT Playground、基于浏览器的工具）。
  • 服务器运行一个 HTTP 端点。如果你的客户端是远程的，你必须将其暴露到互联网。
• Stdio 模式：
  • 适用于通过标准输入/输出（stdio）进行通信的本地客户端。
  • 不打开网络端口。

HTTP 模式（适用于远程客户端）

以 HTTP 模式启动服务器（默认）：

uvx --from git+https://github.com/ish-joshi/leonardo-mcp-server leonardo-mcp-server

如果你的客户端是远程的（例如 ChatGPT Playground），你必须将本地服务器暴露到互联网。你可以使用 ngrok 或类似的隧道工具：

ngrok http 8080

从 ngrok 复制公共 URL，并将其用作客户端中的端点。

Stdio 模式（适用于本地客户端）

以 stdio 模式启动服务器：

uvx --from git+https://github.com/ish-joshi/leonardo-mcp-server leonardo-mcp-server stdio

🔧 技术细节

环境变量

• LEONARDO_API_KEY（必需）：你的 Leonardo AI API 密钥。

开发

• 编辑 main.py 以添加或修改 MCP 工具。
• 使用 python main.py 运行，并使用兼容的 MCP 客户端进行测试。我建议使用 5ire MCP 客户端进行测试。
• 更多信息请参阅 python-sdk 文档。