Sensenova U1 MCP README

sensenova-u1-mcp

SenseNova U1 Fast MCP Server -- 基于 Model Context Protocol (MCP) 的图像生成服务，接入商汤科技 SenseNova U1 Fast 文生图 API。

功能特点

AI 图像生成 -- 通过 MCP 协议调用 SenseNova U1 Fast 文生图 API
中文支持 -- 完全支持中文提示词，描述越详细效果越好
11 种分辨率 -- 支持 16:9 / 9:16 / 1:1 / 3:4 / 4:3 / 21:9 等多种比例
批量生成 -- 单次最多生成 4 张图像
轻量无依赖 -- 纯原生 Fetch API，仅依赖 MCP SDK

快速开始

前置条件

注册 SenseNova 平台并获取 API Key
设置环境变量：

server.ts

# macOS / Linux
export SENSENOVA_API_KEY=sk-xxx

# Windows (CMD)
set SENSENOVA_API_KEY=sk-xxx

# Windows (PowerShell)
$env:SENSENOVA_API_KEY="sk-xxx"

安装

bash

# 全局安装
npm install -g sensenova-u1-mcp

# 或直接运行（无需安装）
npx -y sensenova-u1-mcp

MCP 配置

Claude Desktop / Cursor / VS Code / Cherry Studio

在 MCP 客户端配置文件中添加：

config.json

{
  "mcpServers": {
    "sensenova-u1-fast": {
      "command": "npx",
      "args": ["-y", "sensenova-u1-mcp"],
      "env": {
        "SENSENOVA_API_KEY": "sk-xxx"
      }
    }
  }
}

注意：command 必须为 npx，args 中不含任何本地绝对路径，确保配置可移植。

工具说明

`generate_image`

使用 SenseNova U1 Fast 模型生成图像。

参数	类型	必填	默认值	说明
`prompt`	`string`	是	--	图像描述文本，支持中文，最大约 4096 token。描述越详细效果越好
`size`	`string`	否	`2752x1536`	分辨率，支持 11 种尺寸（见下方表格）
`n`	`integer`	否	`1`	生成数量，范围 1~4

支持的分辨率

尺寸	比例	适用场景
`1344x3136`	9:21	超长竖屏
`1536x2752`	9:16	手机壁纸/海报
`1664x2496`	2:3	竖屏信息图
`1760x2368`	3:4	竖版卡片
`1824x2272`	4:5	社交媒体图文
`2048x2048`	1:1	正方形封面图
`2272x1824`	5:4	横版卡片
`2368x1760`	4:3	平板/展示
`2496x1664`	3:2	横版海报
`2752x1536`	16:9	默认，宽屏/信息图
`3072x1376`	21:9	超宽屏

Prompt 示例

详细的 prompt 能生成更精准的图像。以下是一个完整的示例结构：

text

主题：[简要描述图像主题]
风格：[卡通/写实/扁平/3D 等]
色调：[主色调描述]
布局：[排版说明]
元素：[关键元素列表]
文本：[需要包含的文字内容]

API 参考

本服务基于官方 SenseNova U1 Fast API：

Code

POST https://token.sensenova.cn/v1/images/generations

参数	类型	必填	默认值
`model`	`string`	是	`sensenova-u1-fast`
`prompt`	`string`	是	--
`size`	`string`	否	`2752x1536`
`n`	`integer`	否	`1`

响应结构：