使用说明

项目简介

本项目是一个使用Go语言开发的MCP（Model Context Protocol）服务器，旨在为大型语言模型（LLM）提供图像生成能力。它通过集成OpenAI的DALL-E API，允许LLM客户端调用工具来生成图像，并将图像保存到本地文件系统。

主要功能点

文本到图像生成: 根据LLM提供的文本提示，调用OpenAI DALL-E API生成图像。
可配置图像尺寸: 支持自定义生成的图像宽度和高度。
自动处理保存路径: 自动生成唯一文件名，并将图像保存到指定或默认下载目录。
错误处理和日志: 提供完善的错误处理机制和详细的日志记录，方便问题排查。

安装步骤

安装Go: 确保您的系统已安装 Go 1.19 或更高版本。您可以从 https://go.dev/dl/ 下载并安装。

克隆仓库: 使用 Git 克隆该仓库到本地：

git clone https://github.com/prasanthmj/primitive-go-mcp-server

进入目录: 导航到克隆的仓库目录：

cd primitive-go-mcp-server

构建服务器: 运行以下命令编译 Go 代码，生成可执行文件：
```
go build -o ./bin/imagegen-go ./main
```
这将在 'bin' 目录下生成名为 'imagegen-go' 的可执行文件。

服务器配置

要将此MCP服务器与MCP客户端（例如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器信息。以下是针对 Claude Desktop 的配置示例（通常位于 '~/Library/Application Support/Claude/claude_desktop_config.json'）：

{
  "mcpServers": {
   "imagegen-go": {
      "command": "/path/to/imagegen-go/bin/imagegen-go",
      "env": {
        "OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",  // 替换为您的 OpenAI API 密钥
        "DEFAULT_DOWNLOAD_PATH":"/path/to/download/directory" // 可选：指定默认下载路径，留空则默认为用户下载目录
      }
    }
  }
}

配置说明:

'"imagegen-go"': 服务器名称，您可以自定义。
'"command"': 必填。指向 'imagegen-go' 可执行文件的绝对路径。请将 '/path/to/imagegen-go/bin/imagegen-go' 替换为实际路径，例如 '/Users/yourusername/primitive-go-mcp-server/bin/imagegen-go'。
'"env"': 必填。环境变量配置。
- '"OPENAI_API_KEY"': 必填。您的 OpenAI API 密钥，用于访问 DALL-E API。请替换 '"YOUR_OPENAI_API_KEY"' 为您的实际密钥。
- '"DEFAULT_DOWNLOAD_PATH"': 可选。生成图像的默认下载路径。如果未设置或设置为空字符串，服务器将使用用户Home目录下的 "Downloads" 目录作为默认下载路径。您可以根据需要修改为其他目录的绝对路径，例如 '/Users/yourusername/Pictures'。

请务必根据您的实际文件路径和OpenAI API密钥修改上述配置。

基本使用方法

启动MCP客户端: 配置完成后，启动您的MCP客户端（例如 Claude Desktop）。客户端将自动连接到配置的MCP服务器。
调用图像生成工具: 在MCP客户端中，您可以指示LLM使用 'generate-image' 工具来生成图像。例如，在 Claude 中，您可以输入类似以下的指令：
```
请生成一张电影风格的河边小屋的图片。
```
服务器将接收到请求，调用 OpenAI DALL-E API 生成图像，并将图像保存到您配置的下载路径中。LLM客户端会收到图像保存路径的通知。

关键词