LetzAI MCP 设置指南

本指南将引导您完成设置和使用 LetzAI MCP（模型上下文协议）进行图像生成的过程。

预备条件

在开始之前，请确保您具备以下条件：

• 在您的系统上安装了Node.js。您可以从Node.js 官方网站下载。
• 安装了Claude 桌面应用。如果您还没有安装，可以从Claude 桌面应用下载。
• 拥有LetzAI API 密钥。您可以通过访问LetzAI API获取它。

设置步骤

1. 下载 Git 文件夹

下载包含 LetzAI MCP 项目的仓库，并将其放置在除下载文件夹之外的位置。例如：

C:\\Users\\username\\desktop

或者，您可以使用 git clone 命令克隆仓库：

git clone <repository-url> C:\\Users\\username\\desktop

2. 安装依赖项

通过终端或命令提示符导航到项目文件夹：

cd C:\\Users\\username\\desktop

运行以下命令以安装所有必需的依赖项：

npm install

3. 编译项目

在安装依赖项后，使用以下命令将 TypeScript 文件编译成 JavaScript：

npx tsc

这将在 build 文件夹中生成编译后的 JavaScript 文件。

4. 重启 Claude 应用

在运行 npx tsc 后，必须重启Claude 桌面应用，以便其识别更新的 MCP 配置和编译文件。

5. 在 Claude 桌面应用中设置 MCP 配置

1. 打开Claude 桌面应用。
2. 点击左上角的菜单图标。
3. 从下拉菜单中选择文件。
4. 导航至设置。
5. 在开发者部分，您会看到一个编辑配置选项。
6. 点击编辑配置——这将打开配置文件夹。
7. 查找并编辑文件 claude_desktop_config.json。

Windows 配置：

{
  "mcpServers": {
    "letzai": {
      "command": "node",
      "args": [
        "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\letzai-mcp\\build\\index.js"
      ],
      "env": {
        "LETZAI_API_KEY": "<您的 LetzAI API 密钥>"
      }
    }
  }
}

Ubuntu 配置：

{
  "mcpServers": {
    "letzai": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/letzai-mcp/build/index.js"],
      "env": {
        "LETZAI_API_KEY": "<您的 LetzAI API 密钥>"
      }
    }
  }
}

macOS 配置：

{
  "mcpServers": {
    "letzai": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/letzai-mcp/build/index.js"],
      "env": {
        "LETZAI_API_KEY": "<您的 LetzAI API 密钥>"
      }
    }
  }
}

配置说明

• command: 运行应用程序的命令。我们使用 node 来运行由 TypeScript 生成的 JavaScript 文件。
• args: 这是编译后的 index.js 文件的路径。确保路径根据编译后的文件位置正确无误。如果您已将文件夹放在 C:\\Users\\username\\desktop\\letzai-mcp，则路径应为：

C:\\Users\\username\\desktop\\letzai-mcp\\build\\index.js

6. 运行 MCP 服务器

现在一切就绪，您可以在 Claude 桌面应用中使用 LetzAI MCP。一旦应用运行并带有正确的 API 密钥环境，服务器就应该准备好执行图像生成任务。

重要： 更改配置后，您必须重启 Claude 以使更改生效。

7. 在 Claude 中测试新 MCP

点击锤子图标以查看已安装的 MCP 工具。

在 Claude 桌面应用中设置好 MCP 后，您可以通过运行以下提示来测试它：

• 使用 LetzAI 创建图像，提示："@mischstrotz 喝啤酒的照片，穿着骑士服装"

这将基于提供的提示创建图像，使用 LetzAI 的模型 @mischstrotz。Claude 将在您首选的浏览器中打开该图像。

• 使用强度 1 放大此图像：https://letz.ai/image/d6a67077-f156-46d7-a1a2-1dc49e83dd91

这将使用强度参数 1 放大图像。您可以传递整个 URL，也可以仅传递 LetzAI 图像 ID，例如 d6a67077-f156-46d7-a1a2-1dc49e83dd91

故障排除

• 未找到 Node.js: 确保 Node.js 已安装并且添加到了系统的 PATH 环境变量中。
• 无效的 API 密钥: 再次检查您是否已在 Claude 桌面应用设置中的 LETZAI_API_KEY 变量下正确添加了您的 API 密钥。
• 文件路径问题: 确保 index.js 文件的路径正确。如果您不确定路径，请使用文件的绝对路径。

如需更详细的文档和支持，请访问LetzAI 文档。