项目简介

YourAIPhotographer MCP 服务端是一个实现了 Model Context Protocol (MCP) 的服务器，它作为 YourAIPhotographer 服务的桥梁，使得支持 MCP 协议的客户端（例如 Claude Desktop）能够利用 YourAIPhotographer 平台训练的模型生成定制图像。该服务器定义了一个名为 'generate-custom-image' 的工具，允许客户端通过简单的参数调用 YourAIPhotographer 的图像生成 API。

主要功能点

图像生成工具: 提供 'generate-custom-image' 工具，允许用户指定模型名称、图像描述等参数，调用 YourAIPhotographer API 生成定制图像。
API 密钥管理: 通过环境变量 'YOURAIPHOTOGRAPHER_API_KEY' 管理 YourAIPhotographer API 的密钥，保障 API 调用的安全性。
错误处理: 对 API 调用可能出现的各种错误情况进行详细处理，例如 API 密钥无效、额度不足、模型未找到等，并向客户端返回明确的错误信息。
浏览器自动打开: 成功生成图像后，自动在用户的默认浏览器中打开图像 URL，方便用户查看。

安装步骤

安装 Node.js: 确保您的系统已安装 Node.js (版本 16.x 或更高版本)。您可以从 nodejs.org 下载并安装。

全局安装: 打开终端或命令提示符，运行以下命令全局安装 'youraiphotographer-mcp'：

npm install -g youraiphotographer-mcp

服务器配置

要使 MCP 客户端（如 Claude Desktop）能够连接到 YourAIPhotographer MCP 服务端，您需要在客户端的配置文件中添加服务器配置信息。以 Claude Desktop 为例，您需要在 'claude_desktop_config.json' 文件中添加如下配置：

{
  "mcpServers": {
    "YourAIPhotographer": {
      "command": "youraiphotographer-mcp",
      "env": {
        "YOURAIPHOTOGRAPHER_API_KEY": "<YOUR-API-KEY>"
      }
    }
  }
}

配置参数说明:

'"YourAIPhotographer"': 服务器名称，可以自定义，用于在客户端中标识该服务器。
'"command": "youraiphotographer-mcp"': 启动命令，指定启动 YourAIPhotographer MCP 服务器的命令。安装成功后，'youraiphotographer-mcp' 命令将添加到您的系统路径中。
'"env": { "YOURAIPHOTOGRAPHER_API_KEY": "<YOUR-API-KEY>" }': 环境变量配置，用于设置服务器运行所需的环境变量。
- '"YOURAIPHOTOGRAPHER_API_KEY": "<YOUR-API-KEY>"': API 密钥，您需要将 '<YOUR-API-KEY>' 替换为您在 YourAIPhotographer API Keys 页面获取的 API 密钥。请务必替换为您的真实 API 密钥。

完成配置后，重启您的 MCP 客户端（如 Claude Desktop）使配置生效。

基本使用方法

配置完成后，您就可以在 MCP 客户端中使用 'generate-custom-image' 工具了。以 Claude 为例，您可以使用如下格式的 Prompt 调用该工具：

使用 generate-custom-image 工具，参数如下：
- modelName: <您的模型名称>  //  您在 YourAIPhotographer 平台训练的模型名称
- prompt: <图像描述>       //  您希望生成的图像的描述
- output_format (可选): 'png' 或 'jpg'，默认为 'png'
- aspect_ratio (可选): '1:1', '16:9', '4:3', '9:16' 等，默认为 '1:1'

示例 Prompt:

使用 generate-custom-image 工具，参数如下：
- modelName: my-awesome-model
- prompt: headshot of model, sitting at a desk, at a office, shirt and tie and suit pants

当 Claude 接收到包含 'generate-custom-image' 工具调用的 Prompt 时，YourAIPhotographer MCP 服务端将接收到请求，调用 YourAIPhotographer API 生成图像，并在生成成功后在您的默认浏览器中打开图像。Claude 也会收到包含图像 URL 的文本回复。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息