Tongyi Wanxiang MCP Server

这是一个基于TypeScript的模型上下文协议（MCP）服务器，专门提供阿里巴巴云的全面文本到图像和文本到视频的能力。该服务器允许大型语言模型（LLM）通过MCP协议直接调用Tongyi Wanxiang图像和视频生成API。

<a href="https://glama.ai/mcp/servers/@Suixinlei/tongyi-wanx-mcp-server"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=348737726,3502538757&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Tongyi Wanxiang Server MCP server" /> </a>

特性

• 文学、创意与图形能力集成：与阿里巴巴云的Tongyi Wanxiang Wenshengtu API集成，支持高质量的人工智能图像生成
• Wensheng视频能力集成：与阿里巴巴云Tongyi Wanxiang Wensheng Video API集成，支持高质量的人工智能视频生成
• 异步任务处理：支持长期的图像和视频生成任务，通过异步轮询获取最终结果
• MCP协议支持：符合模型上下文协议规范，可以无缝协作支持MCP的LLMs

环境要求

• Node.js >= 16.x
• Npm>=8. x 或 pnpm

如何使用

以Bailian平台为例

{
  "mcpServers": {
    "tongyi-wanxiang": {
      "command": "npx",
      "args": [
        "-y",
        "tongyi-wanx-mcp-server@latest"
      ],
      "env": {
        "DASHSCOPE_API_KEY": "<你的通义万相 API 密钥>"
      }
    }
  }
}

开发指南

安装依赖

# 使用 npm
npm install

# 或使用 pnpm
pnpm install

构建和运行

# 构建项目
npm run build
# 或
pnpm run build

# 运行服务器
npm start
# 或
pnpm start

# 使用调试工具运行
npm run debug
# 或
pnpm run debug

API 使用

此服务器提供了以下MCP工具：

1. Wanx-t2i-image生成

启动图像生成任务并返回任务ID。

参数：

• prompt：图像生成提示词
• negative_prompt：负面提示词（不希望出现在图像中的元素）

返回：

• 包含 task_id 的任务信息

2. 获取生成结果（wanx-t2i-image生成结果）

通过任务ID获取图像生成结果。

参数：

• task_id：由Wenshengtu生成工具返回的任务ID

返回：

• 图像生成结果，包括图像URL

3. Wanx-t2v-video生成

启动视频生成任务并返回任务ID。

参数：

• prompt：视频生成提示词

返回：

• 包含 task_id 的任务信息

4. 获取视频生成结果（wanx-t2v-video生成结果）

通过任务ID获取视频生成结果。

参数：

• task_id：由Wensheng Video生成工具返回的任务ID

返回：

• 视频生成结果，包括视频URL

项目结构

project/
├── src/                  # 源代码目录
│   ├── index.ts          # 主入口文件，MCP 服务器定义
│   ├── wanx-t2i.js       # 通义万相文生图 API 集成
│   ├── wanx-t2v.js       # 通义万相文生视频 API 集成
│   └── config.ts         # 配置文件
├── dist/                 # 编译后的代码目录
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript 配置
└── README.md             # 项目说明

Tongyi Wanxiang API 参数解释

Wenshengtu API 支持的参数

• model：模型名称，默认是 wanx2.1-t2i-turbo
• size：图像大小，默认是 1024*1024
• n：生成图像的数量，默认是1
• seed：随机种子，用于重现结果
• prompt_extend：启用提示词扩展，默认为true
• watermark：添加水印，默认为false

高级配置

您可以在 src/config.ts 中修改以下配置：

• pollingInterval：轮询任务状态的时间间隔（毫秒）
• maxRetries：最大轮询次数
• Defaultodel：默认使用的模型

注意事项

1. 请确保您拥有访问Tongyi Wanxiang API的有效权限和密钥
2. 图像生成是一个异步过程，可能需要几秒到几十秒的时间
3. 视频生成过程耗时较长，可能需要几分钟到几十分钟
4. 查询视频生成状态可能会多次失败，系统会自动重试，请耐心等待
5. 请合理设置轮询间隔和最大重试次数，以适应您的使用场景
6. 对于视频生成任务，建议增加最大重试次数和轮询间隔时间

参考资料

• Tongyi Wanxiang API 文档
• 模型上下文协议（MCP）规范