项目简介

DeepChat图像工具MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在为 DeepChat 等大型语言模型 (LLM) 应用提供图像处理能力。它聚合了多种图像处理工具,并通过标准化的 MCP 协议与 LLM 客户端进行通信,使得 LLM 可以方便地调用各种图像生成和编辑功能。目前主要聚焦于国产图像处理能力,方便用户本地或云端部署。

主要功能点

  • 海报生成: 根据用户输入的标题、副标题、内容和提示词,生成定制化的海报图片。
  • 图像风格化: 将用户提供的图片文件进行风格转换,支持多种艺术风格,例如网红日漫风、3D、水墨风等。
  • 可扩展性: 基于 'go-mcp' 框架构建,易于扩展新的图像处理工具。
  • 多种传输协议: 支持 SSE 和 Stdio 两种传输协议,满足不同部署环境的需求。

安装步骤

  1. 克隆仓库

    git clone https://github.com/songjiayang/deepchat-tools.git
    cd deepchat-tools
  2. 配置环境变量

    复制 'env.sh.example' 文件并重命名为 'env.sh',根据您的实际情况修改以下环境变量:

    DASHSCOPE_API_KEY=YOUR_DASHSCOPE_API_KEY  # 阿里云 DashScope API Key,用于海报生成
    VolcAccessKeyID=YOUR_VOLC_ACCESS_KEY_ID    # 火山引擎 Access Key ID,用于图像风格化
    VolcSecretAccessKey=YOUR_VOLC_SECRET_ACCESS_KEY # 火山引擎 Secret Access Key,用于图像风格化

    注意: 请务必替换 'YOUR_DASHSCOPE_API_KEY'、'YOUR_VOLC_ACCESS_KEY_ID' 和 'YOUR_VOLC_SECRET_ACCESS_KEY' 为您自己的 API 密钥。您需要分别开通阿里云 DashScope 和火山引擎视觉智能服务,并获取相应的 API 密钥。

    并在终端执行命令使环境变量生效:

    source env.sh
  3. 运行服务器

    在仓库根目录下,执行以下命令启动 MCP 服务器:

    go run main.go

    默认情况下,服务器使用 SSE 协议,监听地址为 '127.0.0.1:8082'。您也可以通过命令行参数修改传输协议和监听地址,例如使用 Stdio 协议:

    go run main.go --transport stdio

    或者修改 SSE 监听地址:

    go run main.go --transport sse --server_listen 0.0.0.0:8083

服务器配置 (MCP 客户端)

以下 JSON 配置信息用于配置 MCP 客户端连接到 DeepChat图像工具MCP Server。请根据您实际使用的传输协议 (SSE 或 Stdio) 选择相应的配置:

SSE 协议配置 (默认)

{
  "server name": "DeepChat Tools",
  "command": "go",
  "args": [
    "run",
    "main.go",
    "--transport",
    "sse",
    "--server_listen",
    "127.0.0.1:8082"
  ]
}

Stdio 协议配置

{
  "server name": "DeepChat Tools",
  "command": "go",
  "args": [
    "run",
    "main.go",
    "--transport",
    "stdio"
  ]
}

配置说明:

  • '"server name"': MCP 服务器的名称,用于客户端识别。
  • '"command"': 启动 MCP 服务器的命令,这里使用 'go run'。
  • '"args"': 传递给 'go run' 命令的参数列表。
    • '"run"', '"main.go"': 运行 'main.go' 文件。
    • '"--transport"': 指定传输协议,可选值为 '"sse"' (SSE 协议) 或 '"stdio"' (Stdio 协议)。
    • '"--server_listen"': 仅当使用 SSE 协议时有效,指定 SSE 服务器监听的地址和端口。请根据实际情况修改。

基本使用方法

  1. 启动 MCP 客户端: 确保您已安装并配置了支持 MCP 协议的客户端,例如 DeepChat。

  2. 配置 MCP 服务器: 在 MCP 客户端中,根据您选择的传输协议 (SSE 或 Stdio),填入上述相应的服务器配置信息。

  3. 连接 MCP 服务器: 启动 MCP 客户端,客户端将根据配置信息连接到 DeepChat图像工具MCP Server。

  4. 调用工具: 在 MCP 客户端中,您应该能够看到 "海报生成" 和 "图片风格化" 这两个工具。根据工具的输入参数描述,提供相应的参数,即可调用工具进行图像处理。

    例如,使用 "海报生成" 工具时,您需要提供标题、副标题、主要内容和文生图提示词等信息。服务器将调用后端服务生成海报图片,并将图片 URL 返回给客户端。

    使用 "图像风格化" 工具时,您需要提供本地图片文件路径和风格名称。服务器将读取图片文件,进行风格转换,并将风格化后的图片 URL 返回给客户端。

    具体工具的使用方法和参数请参考 MCP 客户端的界面和文档。

信息

分类

AI与计算