使用说明

项目简介

Image Generator MCP Server 是一个基于 Model Context Protocol (MCP) 的后端服务，它扩展了大型语言模型 (LLM) 的能力，使其能够生成图像。该服务器利用 OpenAI 的 DALL-E 3 模型，通过 MCP 协议与 LLM 客户端通信，提供图像生成功能。

主要功能点

图像生成工具 (generate_image): 提供 'generate_image' 工具，允许 LLM 客户端通过文本 prompt 生成图像。
- 用户需要提供 'prompt' (图像描述文本) 和 'imageName' (图像文件名) 两个参数。
- 生成的图像将以 PNG 格式保存在用户桌面名为 'generated-images' 的文件夹中。

安装步骤

安装 Node.js 和 npm: 确保你的电脑上已安装 Node.js 和 npm (Node 包管理器)。
下载仓库代码: 从 GitHub 仓库 https://github.com/luoshui-coder/image-generator-mcp-server 下载代码到本地。
安装依赖: 打开终端或命令提示符，进入仓库代码根目录，运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```
配置 OpenAI API 密钥:
- 在仓库根目录下创建 '.env' 文件（如果不存在）。
- 在 '.env' 文件中添加以下内容，并将 '<your-openai-api-key>' 替换为你的 OpenAI API 密钥：
```
OPENAI_API_KEY=<your-openai-api-key>
```

服务器配置

要将 Image Generator MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要配置客户端以连接到该服务器。以下是 Claude Desktop 的配置示例，你需要将以下 JSON 配置添加到 Claude Desktop 的配置文件中。

Claude Desktop 配置文件路径：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置信息 (claude_desktop_config.json):

{
  "mcpServers": {
    "image-generator": {
      "command": "image-generator",
      "env": {
        "OPENAI_API_KEY": "<your-openai-api-key>"  // 请替换为你的 OpenAI API 密钥
      }
    }
  }
}

配置说明:

'"image-generator"': 服务器的名称，可以自定义，用于在客户端中标识该服务器。
'"command": "image-generator"': 启动服务器的命令。 由于 'package.json' 中已经配置了 'bin' 字段，并且在 'src/index.ts' 文件头部使用了 '#!/usr/bin/env node'，因此可以直接使用 'image-generator' 命令来启动服务器。
'"env"': 环境变量配置。 'OPENAI_API_KEY' 环境变量用于传递 OpenAI API 密钥给服务器。 请务必将 '<your-openai-api-key>' 替换为你自己的 OpenAI API 密钥。

基本使用方法

启动服务器: 在终端或命令提示符中，进入仓库代码根目录，运行以下命令启动服务器：
```
npm start
```
或者直接运行构建后的 JavaScript 文件：
```
node dist/index.js
```
服务器成功启动后，会在终端的 错误输出 (stderr) 中打印 "Weather MCP server running on stdio" (这是一个信息性消息，可以忽略 "Weather" 单词，实际是 Image Generator 服务器启动信息)。
在 MCP 客户端中使用: 配置完成后，在支持 MCP 协议的客户端（例如 Claude Desktop）中，LLM 就可以调用 'generate_image' 工具来生成图像了。你需要在客户端的交互界面中，指示 LLM 使用 'generate_image' 工具，并提供 'prompt' 和 'imageName' 参数。例如，你可以指示 Claude 助手 "使用 generate_image 工具生成一张猫的图片，图片名称为 cat"。
查看生成的图像: 生成的图像将保存在你桌面 'generated-images' 文件夹中，文件名为你指定的 'imageName' (PNG 格式)。

调试

如果需要调试 MCP 服务器，可以使用仓库提供的 'inspector' 工具，运行以下命令：

npm run inspector

按照提示访问浏览器中的调试工具 URL。

关键词