SenseNova U1 Fast MCP 服务器

redmingwei/sensenova-u1-mcp

Hosted

0 Stars 81 次浏览 redmingwei 更新于 2026-08-23

基于 Model Context Protocol (MCP) 的图像生成服务，接入商汤科技 SenseNova U1 Fast 文生图 API。完全支持中文提示词，提供 11 种分辨率选项，并且单次最多可生成 4 张图像。

文化艺术

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：SENSENOVA_API_KEY

可用工具（1 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

generate_image 3 个参数需填 1 项使用 SenseNova U1 Fast 模型，根据文本描述生成图像。支持中文 prompt，返回临时 URL 请及时下载。

使用 SenseNova U1 Fast 模型，根据文本描述生成图像。支持中文 prompt，返回临时 URL 请及时下载。

必填参数：prompt

服务介绍

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
设置环境变量：

# macOS / Linux
export SENSENOVA_API_KEY=sk-xxx

# Windows (CMD)
set SENSENOVA_API_KEY=sk-xxx

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

安装

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

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

🔧 MCP 配置

Claude Desktop / Cursor / VS Code / Cherry Studio

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

{
  "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

支持的分辨率

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

Prompt 示例

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

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

详见官方文档示例中 U1 Fast 的 prompt 写法。

📖 API 参考

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

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

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

响应结构：

{
  "created": 1713167890,
  "data": [
    { "url": "https://cdn.sensenova.dev/gen/..." }
  ]
}

错误码

HTTP	含义	处理建议
400	参数不合法	检查请求参数
403	权限不足	检查 API Key
429	额度超限	每 5 小时 1500 次限制，稍后重试
500	服务端错误	稍后重试

💻 开发指南

本地开发

# 克隆仓库
git clone https://github.com/Microbiosis/sensenova-u1-mcp.git
cd sensenova-u1-mcp

# 安装依赖
npm install

# 设置环境变量
export SENSENOVA_API_KEY=sk-xxx

# 运行
node index.js

项目结构

sensenova-u1-mcp/
├── index.js          # MCP 服务器主入口
├── server.json       # MCP Registry 注册配置
├── package.json
├── README.md
├── LICENSE           # MIT 许可证
├── .editorconfig     # 编辑器代码风格配置
├── .gitignore
└── .npmignore

发布到 npm

# 更新版本号
npm version patch   # 1.0.0 → 1.0.1
npm version minor   # 1.0.0 → 1.1.0
npm version major   # 1.0.0 → 2.0.0

# 发布
npm publish

# 验证
npx -y sensenova-u1-mcp

📄 许可证

查看源码项目主页