返回 MCP 目录
public公开dns本地运行

together-ai-image-server

基于Together AI API的图像生成MCP服务器

article

README

🚀 一起AI图像服务器

这是一个基于TypeScript的MCP(模型上下文协议)服务器,借助它可通过Together AI API生成图像。

🚀 快速开始

该服务器提供了一个简单的接口,可通过MCP协议使用Together AI的图像生成模型生成图像。它允许Claude和其他兼容MCP的助手根据文本提示生成图像。

✨ 主要特性

工具

  • generate_image - 从文本提示生成图像
    • 接受一个文本提示作为必填参数
    • 控制生成步骤和图像数量的可选参数
    • 返回生成图像的URL和本地路径

📦 安装指南

先决条件

  • Node.js(建议v14或更高版本)
  • Together AI API密钥

安装步骤

# 克隆仓库
git clone https://github.com/zym9863/together-ai-image-server.git
cd together-ai-image-server

# 安装依赖项
npm install

配置

设置您的Together AI API密钥为环境变量:

# 在Linux/macOS上
export TOGETHER_API_KEY="your-api-key-here"

# 在Windows(命令提示符)
set TOGETHER_API_KEY=your-api-key-here

# 在Windows(PowerShell)
$env:TOGETHER_API_KEY="your-api-key-here"

或者,可以在项目根目录创建一个.env文件:

TOGETHER_API_KEY=your-api-key-here

开发

构建服务器:

npm run build

带有自动重建的开发:

npm run watch

与Claude Desktop一起使用

要与Claude Desktop一起使用,请添加服务器配置: 在macOS上:~/Library/Application Support/Claude/claude_desktop_config.json
在Windows上:%APPDATA%/Claude/claude_desktop_config.json%

{
  "mcpServers": {
    "Together AI Image Server": {
      "command": "/path/to/together-ai-image-server/build/index.js"
    }
  }
}

/path/to/together-ai-image-server替换为您实际安装的路径。

调试

由于MCP服务器通过stdio通信,调试可能具有挑战性。我们推荐使用MCP Inspector,它作为包脚本可用:

npm run inspector

Inspector将在您的浏览器中提供一个访问调试工具的URL。

📚 详细文档

API参考

generate_image

根据文本提示使用Together AI的图像生成API生成图像。

参数:

  • prompt(字符串,必需):用于图像生成的文本提示
  • steps(数字,可选,默认值:4):扩散步骤的数量(1 - 4)
  • n(数字,可选):(原文档此处缺失描述,保留原样)
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端