项目简介
DeepChat图像工具MCP Server 是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在为 DeepChat 等大型语言模型 (LLM) 应用提供图像处理能力。它聚合了多种图像处理工具,并通过标准化的 MCP 协议与 LLM 客户端进行通信,使得 LLM 可以方便地调用各种图像生成和编辑功能。目前主要聚焦于国产图像处理能力,方便用户本地或云端部署。
主要功能点
- 海报生成: 根据用户输入的标题、副标题、内容和提示词,生成定制化的海报图片。
- 图像风格化: 将用户提供的图片文件进行风格转换,支持多种艺术风格,例如网红日漫风、3D、水墨风等。
- 可扩展性: 基于 'go-mcp' 框架构建,易于扩展新的图像处理工具。
- 多种传输协议: 支持 SSE 和 Stdio 两种传输协议,满足不同部署环境的需求。
安装步骤
-
克隆仓库
git clone https://github.com/songjiayang/deepchat-tools.git cd deepchat-tools -
配置环境变量
复制 '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 -
运行服务器
在仓库根目录下,执行以下命令启动 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 服务器监听的地址和端口。请根据实际情况修改。
基本使用方法
-
启动 MCP 客户端: 确保您已安装并配置了支持 MCP 协议的客户端,例如 DeepChat。
-
配置 MCP 服务器: 在 MCP 客户端中,根据您选择的传输协议 (SSE 或 Stdio),填入上述相应的服务器配置信息。
-
连接 MCP 服务器: 启动 MCP 客户端,客户端将根据配置信息连接到 DeepChat图像工具MCP Server。
-
调用工具: 在 MCP 客户端中,您应该能够看到 "海报生成" 和 "图片风格化" 这两个工具。根据工具的输入参数描述,提供相应的参数,即可调用工具进行图像处理。
例如,使用 "海报生成" 工具时,您需要提供标题、副标题、主要内容和文生图提示词等信息。服务器将调用后端服务生成海报图片,并将图片 URL 返回给客户端。
使用 "图像风格化" 工具时,您需要提供本地图片文件路径和风格名称。服务器将读取图片文件,进行风格转换,并将风格化后的图片 URL 返回给客户端。
具体工具的使用方法和参数请参考 MCP 客户端的界面和文档。
信息
分类
AI与计算