nx-mcp-server 1.0.0

package/.claude/settings.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "nx-mcp": {
+      "command": "node",
+      "args": ["src/index.js"],
+      "env": {
+        "DASHSCOPE_API_KEY": ""
+      }
+    }
+  }
+}

package/README.md

@@ -0,0 +1,168 @@
+# NX MCP Server
+
+图像生成 MCP Server——智能生图（通义万相 API）+ 本地图形工具集，支持 Stdio 和 HTTP 双传输模式。
+
+## 工具列表
+
+### 智能生图（通义万相 API）
+| 工具 | 说明 |
+|------|------|
+| `generate_smart` | 文生图，调用通义万相模型 |
+
+### 本地图形工具（无需网络/API Key）
+| 工具 | 说明 |
+|------|------|
+| `generate_basic` | 图形合成：形状/文字/图片叠加 |
+| `generate_qrcode` | 二维码生成（支持中心 logo + 文字水印） |
+| `generate_barcode` | 条形码生成（CODE128/CODE39/EAN13/EAN8/UPC/ITF） |
+| `compress_image` | 图片压缩（质量/尺寸） |
+| `convert_format` | 格式互转（PNG↔JPEG↔WebP↔BMP↔TIFF→AVIF） |
+| `stitch_images` | 多图拼接/网格布局 |
+| `extract_colors` | 提取图片主色调（hex/rgb/hsl） |
+| `add_watermark` | 文字/图片水印（支持平铺） |
+
+## 快速开始
+
+### 方式一：魔搭 MCP 广场（推荐）
+
+在魔搭 MCP 广场搜索 **NX MCP Server**，一键同步到 Cherry Studio 或复制配置到其他客户端。
+
+### 方式二：npx 一键运行
+
+无需安装，客户端配置中填入：
+
+```json
+{
+  "mcpServers": {
+    "nx-mcp": {
+      "command": "npx",
+      "args": ["-y", "nx-mcp-server"]
+    }
+  }
+}
+```
+
+如果要用智能生图，传入 API Key：
+
+```json
+{
+  "mcpServers": {
+    "nx-mcp": {
+      "command": "npx",
+      "args": ["-y", "nx-mcp-server"],
+      "env": {
+        "DASHSCOPE_API_KEY": "sk-你的key"
+      }
+    }
+  }
+}
+```
+
+### 方式三：源码安装
+
+```bash
+git clone git@gitee.com:san_jing/nx-mcp-server.git
+cd nx-mcp-server
+npm install
+```
+
+客户端配置：
+
+```json
+{
+  "mcpServers": {
+    "nx-mcp": {
+      "command": "node",
+      "args": ["/你的路径/nx-mcp-server/src/index.js"],
+      "env": {
+        "DASHSCOPE_API_KEY": "sk-你的key"
+      }
+    }
+  }
+}
+```
+
+## API Key
+
+智能生图（`generate_smart`）需要通义万相 API Key，四种传入方式按优先级排序：
+
+1. **调用时传参**：使用 `generate_smart` 时传入 `apiKey` 参数
+2. **MCP 客户端 env**：配置中设置 `DASHSCOPE_API_KEY`（见上方示例）
+3. **系统环境变量**：`export DASHSCOPE_API_KEY="sk-xxx"`
+4. **config.json**：项目根目录 `config.json` 中配置 `dashscope_api_key`
+
+> 其余 8 个本地工具无需 API Key，可直接使用。
+
+## 传输模式
+
+| 模式 | 环境变量 | 适用场景 |
+|------|---------|---------|
+| **Stdio**（默认） | 不设 | 本地 Claude Code、Cherry Studio |
+| **HTTP** | `MCP_TRANSPORT=http` | 魔搭云端托管、远程访问 |
+
+## 使用示例
+
+### 智能生图
+
+```
+用 generate_smart 生成一张 prompt 为 "夕阳下的海边灯塔，水彩风格" 的图片
+```
+
+### 普通生图
+
+```
+用 generate_basic 生成一张 800×400 深蓝色背景、中间白色文字 "Hello World" 的 banner
+```
+
+### 图片拼接
+
+```
+把这三张图片用 stitch_images 拼成 2 列的网格
+```
+
+### 取色 + 水印
+
+```
+先 extract_colors 提取这张图的 5 个主色，再用 add_watermark 加文字水印，颜色用提取的第一个颜色
+```
+
+## 支持的客户端
+
+- Cherry Studio（魔搭一键同步）
+- Claude Desktop / Claude Code
+- Cursor / VS Code
+- 通义灵码
+- 任何支持 MCP 协议的客户端
+
+## 项目结构
+
+```
+src/
+├── index.js                # MCP Server 主入口
+├── providers/
+│   └── tongyi.js           # 通义万相 API
+├── tools/
+│   ├── smart.js            # 智能生图
+│   ├── basic.js            # 普通生图
+│   ├── qrcode.js           # 二维码
+│   ├── barcode.js          # 条形码
+│   ├── compress.js         # 图片压缩
+│   ├── convert.js          # 格式转换
+│   ├── stitch.js           # 图片拼接
+│   ├── colors.js           # 取色
+│   └── watermark.js        # 水印
+└── utils/
+    ├── output.js           # 文件输出
+    └── gradient.js         # 渐变背景
+```
+
+## 依赖
+
+- `@modelcontextprotocol/sdk` — MCP 协议
+- `sharp` — 高性能图片处理
+- `qrcode` — 二维码生成
+- `axios` — HTTP 请求
+
+## License
+
+MIT

package/config.json

@@ -0,0 +1,7 @@
+{
+  "dashscope_api_key": "",
+  "outputDir": "./output",
+  "defaultModel": "wanx-v1",
+  "defaultWidth": 1024,
+  "defaultHeight": 1024
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "nx-mcp-server",
+  "version": "1.0.0",
+  "description": "图像生成 MCP Server — 智能生图(万相API) + 本地图形工具集",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "nx-mcp": "./src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "start:http": "cross-env MCP_TRANSPORT=http MCP_PORT=3000 node src/index.js",
+    "dev": "node --watch src/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "sharp": "^0.33.0",
+    "qrcode": "^1.5.3",
+    "axios": "^1.7.0",
+    "express": "^4.19.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": ["mcp", "image-generation", "qrcode", "watermark", "image-processing"],
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,343 @@
+import {Server} from '@modelcontextprotocol/sdk/server/index.js';
+import {StdioServerTransport} from '@modelcontextprotocol/sdk/server/stdio.js';
+import {CallToolRequestSchema, ListToolsRequestSchema} from '@modelcontextprotocol/sdk/types.js';
+import {generateSmart} from './tools/smart.js';
+import {generateBasic} from './tools/basic.js';
+import {generateQrcode} from './tools/qrcode.js';
+import {generateBarcode} from './tools/barcode.js';
+import {compressImage} from './tools/compress.js';
+import {convertFormat} from './tools/convert.js';
+import {stitchImages} from './tools/stitch.js';
+import {extractColors} from './tools/colors.js';
+import {addWatermark} from './tools/watermark.js';
+
+// ===== 工具注册表 =====
+const tools=[
+  {
+    name:'generate_smart',
+    description:'智能生图：调用通义万相 API 文生图，自动下载保存到本地 output 目录',
+    inputSchema:{
+      type:'object',
+      properties:{
+        apiKey:{type:'string',description:'通义千问 API Key（可选，未传则读取环境变量 DASHSCOPE_API_KEY）'},
+        prompt:{type:'string',description:'图像描述提示词'},
+        negativePrompt:{type:'string',description:'负面提示词'},
+        width:{type:'integer',description:'宽度(px)',default:1024},
+        height:{type:'integer',description:'高度(px)',default:1024},
+        style:{type:'string',description:'风格预设',enum:['photorealistic','anime','oil-painting','watercolor','3d-render','sketch','flat-illustration']},
+        model:{type:'string',description:'模型名称',default:'wanx-v1'},
+        numImages:{type:'integer',description:'生成数量',default:1,minimum:1,maximum:4},
+        outputFormat:{type:'string',description:'输出格式',enum:['url','base64','file'],default:'url'},
+        outputDir:{type:'string',description:'输出目录'},
+      },
+      required:['prompt'],
+    },
+  },
+  {
+    name:'generate_basic',
+    description:'普通生图：本地 Canvas 合成图形',
+    inputSchema:{
+      type:'object',
+      properties:{
+        width:{type:'integer',description:'画布宽度(px)',default:800},
+        height:{type:'integer',description:'画布高度(px)',default:600},
+        background:{type:'string',description:'背景：纯色(hex)、渐变 JSON、transparent',default:'#ffffff'},
+        shapes:{type:'array',description:'图形列表',items:{type:'object',properties:{
+          type:{type:'string',enum:['rect','circle','ellipse','line','polygon']},
+          x:{type:'number'},y:{type:'number'},w:{type:'number'},h:{type:'number'},
+          r:{type:'number',description:'圆/椭圆半径或rx'},
+          ry:{type:'number',description:'椭圆ry'},
+          points:{type:'array',description:'多边形/线段端点',items:{type:'object',properties:{x:{type:'number'},y:{type:'number'}},required:['x','y']}},
+          fill:{type:'string',description:'填充色'},
+          stroke:{type:'string',description:'描边色'},
+          strokeWidth:{type:'number'},
+        },required:['type']}},
+        texts:{type:'array',description:'文字列表',items:{type:'object',properties:{
+          content:{type:'string'},x:{type:'number'},y:{type:'number'},
+          fontSize:{type:'number',default:24},color:{type:'string',default:'#000000'},
+          fontFamily:{type:'string',default:'sans-serif'},align:{type:'string',enum:['left','center','right']},
+          maxWidth:{type:'number'},
+        },required:['content','x','y']}},
+        images:{type:'array',description:'叠加图片',items:{type:'object',properties:{
+          src:{type:'string',description:'图片路径/URL'},x:{type:'number'},y:{type:'number'},
+          width:{type:'number'},height:{type:'number'},opacity:{type:'number',minimum:0,maximum:1},
+        },required:['src']}},
+        border:{type:'object',properties:{width:{type:'number'},color:{type:'string'},radius:{type:'number'}}},
+        format:{type:'string',enum:['png','jpeg','webp'],default:'png'},
+        quality:{type:'integer',minimum:1,maximum:100,default:90},
+        outputDir:{type:'string',description:'输出目录'},
+      },
+      required:['width','height'],
+    },
+  },
+  {
+    name:'generate_qrcode',
+    description:'生成二维码（支持中心logo+文字水印，一站式美化）',
+    inputSchema:{
+      type:'object',
+      properties:{
+        content:{type:'string',description:'编码内容'},
+        width:{type:'integer',description:'尺寸(px)',default:256},
+        margin:{type:'integer',description:'边距',default:4},
+        darkColor:{type:'string',default:'#000000'},
+        lightColor:{type:'string',default:'#ffffff'},
+        errorLevel:{type:'string',enum:['L','M','Q','H'],default:'M'},
+        logo:{type:'string',description:'中心logo图片路径(可选，自动加白色圆角背景遮挡QR图案)'},
+        watermark:{type:'object',description:'文字水印(可选)',properties:{
+          text:{type:'string',description:'水印文字'},
+          position:{type:'string',enum:['top','bottom'],default:'bottom'},
+          fontSize:{type:'integer',default:14},
+          color:{type:'string',description:'文字颜色'},
+          opacity:{type:'number',minimum:0,maximum:1,default:0.4},
+        }},
+        outputDir:{type:'string'},
+      },
+      required:['content'],
+    },
+  },
+  {
+    name:'generate_barcode',
+    description:'生成条形码',
+    inputSchema:{
+      type:'object',
+      properties:{
+        content:{type:'string',description:'编码内容(数字/字母)'},
+        format:{type:'string',enum:['CODE128','CODE39','EAN13','EAN8','UPC','ITF'],default:'CODE128'},
+        width:{type:'integer',description:'宽度(px)',default:400},
+        height:{type:'integer',description:'高度(px)',default:100},
+        displayValue:{type:'boolean',description:'是否显示编码文字',default:true},
+        fontSize:{type:'integer',default:16},
+        outputDir:{type:'string'},
+      },
+      required:['content'],
+    },
+  },
+  {
+    name:'compress_image',
+    description:'压缩图片（质量/尺寸）',
+    inputSchema:{
+      type:'object',
+      properties:{
+        src:{type:'string',description:'源图片路径/URL'},
+        quality:{type:'integer',minimum:1,maximum:100,description:'JPEG/WebP质量',default:80},
+        maxWidth:{type:'integer',description:'最大宽度(等比缩放)'},
+        maxHeight:{type:'integer',description:'最大高度(等比缩放)'},
+        format:{type:'string',enum:['jpeg','webp','png'],description:'输出格式',default:'jpeg'},
+        outputDir:{type:'string'},
+      },
+      required:['src'],
+    },
+  },
+  {
+    name:'convert_format',
+    description:'图片格式互转（PNG↔JPEG↔WebP↔BMP↔TIFF）',
+    inputSchema:{
+      type:'object',
+      properties:{
+        src:{type:'string',description:'源图片路径/URL'},
+        format:{type:'string',enum:['png','jpeg','webp','bmp','tiff','avif'],description:'目标格式'},
+        quality:{type:'integer',minimum:1,maximum:100,default:90},
+        background:{type:'string',description:'透明图转不透明格式时的背景色',default:'#ffffff'},
+        outputDir:{type:'string'},
+      },
+      required:['src','format'],
+    },
+  },
+  {
+    name:'stitch_images',
+    description:'多图拼接/网格布局',
+    inputSchema:{
+      type:'object',
+      properties:{
+        sources:{type:'array',description:'图片路径列表',items:{type:'string'}},
+        columns:{type:'integer',description:'列数',default:2},
+        gap:{type:'integer',description:'间距(px)',default:0},
+        background:{type:'string',default:'#ffffff'},
+        align:{type:'string',enum:['top','center','bottom'],default:'center'},
+        format:{type:'string',enum:['png','jpeg','webp'],default:'png'},
+        outputDir:{type:'string'},
+      },
+      required:['sources'],
+    },
+  },
+  {
+    name:'extract_colors',
+    description:'提取图片主色调/调色板',
+    inputSchema:{
+      type:'object',
+      properties:{
+        src:{type:'string',description:'图片路径/URL'},
+        count:{type:'integer',description:'提取颜色数量',default:5,minimum:2,maximum:20},
+        format:{type:'string',enum:['hex','rgb','hsl'],default:'hex'},
+      },
+      required:['src'],
+    },
+  },
+  {
+    name:'add_watermark',
+    description:'添加文字/图片水印',
+    inputSchema:{
+      type:'object',
+      properties:{
+        src:{type:'string',description:'源图片路径/URL'},
+        type:{type:'string',enum:['text','image'],description:'水印类型'},
+        content:{type:'string',description:'文字水印内容'},
+        imageSrc:{type:'string',description:'图片水印路径'},
+        position:{type:'string',enum:['topLeft','topRight','bottomLeft','bottomRight','center','tile'],default:'bottomRight'},
+        margin:{type:'integer',default:20},
+        opacity:{type:'number',minimum:0,maximum:1,default:0.5},
+        fontSize:{type:'integer',default:36},
+        color:{type:'string',default:'#ffffff'},
+        fontSize:{type:'integer',default:36},
+        angle:{type:'integer',description:'旋转角度(仅tile模式)',default:-30},
+        outputDir:{type:'string'},
+      },
+      required:['src','type'],
+    },
+  },
+];
+
+// ===== 工具路由 =====
+const handlers={
+  generate_smart:generateSmart,
+  generate_basic:generateBasic,
+  generate_qrcode:generateQrcode,
+  generate_barcode:generateBarcode,
+  compress_image:compressImage,
+  convert_format:convertFormat,
+  stitch_images:stitchImages,
+  extract_colors:extractColors,
+  add_watermark:addWatermark,
+};
+
+// ===== 创建 MCP Server =====
+function createServer(){
+  const server=new Server(
+    {name:'nx-mcp-server',version:'1.0.0'},
+    {capabilities:{tools:{}}},
+  );
+
+  server.setRequestHandler(ListToolsRequestSchema,async()=>{
+    return {tools};
+  });
+
+  server.setRequestHandler(CallToolRequestSchema,async(request)=>{
+    const {name,arguments:args}=request.params;
+    const handler=handlers[name];
+    if(!handler){
+      return {content:[{type:'text',text:`Unknown tool: ${name}`}],isError:true};
+    }
+    try{
+      const result=await handler(args);
+      return {
+        content:[{type:'text',text:JSON.stringify(result,null,2)}],
+      };
+    }catch(err){
+      return {
+        content:[{type:'text',text:`Error: ${err.message}`}],
+        isError:true,
+      };
+    }
+  });
+
+  return server;
+}
+
+// ===== HTTP 模式（魔塔 Remote / 远程访问） =====
+async function startHttp(){
+  const {StreamableHTTPServerTransport}=await import('@modelcontextprotocol/sdk/server/streamableHttp.js');
+  const {createMcpExpressApp}=await import('@modelcontextprotocol/sdk/server/express.js');
+  const {randomUUID}=await import('node:crypto');
+
+  const PORT=parseInt(process.env.MCP_PORT||'3000',10);
+  const app=createMcpExpressApp({host:'0.0.0.0'});
+  const transports={};// sessionId → transport
+
+  const mcpPostHandler=async (req,res)=>{
+    const sessionId=req.headers['mcp-session-id'];
+    let transport;
+
+    if(sessionId&&transports[sessionId]){
+      transport=transports[sessionId];
+    }else if(!sessionId){
+      // 新会话初始化
+      const eventStore={
+        events:[],
+        getLastEventId:()=>eventStore.events.length.toString(),
+        storeEvent:(ev)=>{eventStore.events.push(ev);},
+        getEventsAfter:(id)=>eventStore.events.slice(parseInt(id)||0),
+      };
+      transport=new StreamableHTTPServerTransport({
+        sessionIdGenerator:()=>randomUUID(),
+        eventStore,
+        onsessioninitialized:(sid)=>{
+          transports[sid]=transport;
+        },
+      });
+      transport.onclose=()=>{
+        const sid=transport.sessionId;
+        if(sid) delete transports[sid];
+      };
+      const server=createServer();
+      await server.connect(transport);
+      await transport.handleRequest(req,res,req.body);
+      return;
+    }else{
+      res.status(400).json({jsonrpc:'2.0',error:{code:-32000,message:'无效 Session ID'},id:null});
+      return;
+    }
+    await transport.handleRequest(req,res,req.body);
+  };
+
+  const mcpGetHandler=async (req,res)=>{
+    const sessionId=req.headers['mcp-session-id'];
+    if(!sessionId||!transports[sessionId]){
+      res.status(400).send('无效或缺少 session ID');
+      return;
+    }
+    await transports[sessionId].handleRequest(req,res);
+  };
+
+  const mcpDeleteHandler=async (req,res)=>{
+    const sessionId=req.headers['mcp-session-id'];
+    if(!sessionId||!transports[sessionId]){
+      res.status(400).send('无效或缺少 session ID');
+      return;
+    }
+    await transports[sessionId].handleRequest(req,res);
+  };
+
+  app.post('/mcp',mcpPostHandler);
+  app.get('/mcp',mcpGetHandler);
+  app.delete('/mcp',mcpDeleteHandler);
+
+  // 健康检查
+  app.get('/health',(_req,res)=>{res.json({status:'ok',uptime:process.uptime()});});
+
+  app.listen(PORT,()=>{
+    console.error(`NX MCP Server (HTTP) → http://0.0.0.0:${PORT}/mcp`);
+  });
+}
+
+// ===== Stdio 模式（本地 Claude Code） =====
+async function startStdio(){
+  const server=createServer();
+  const transport=new StdioServerTransport();
+  await server.connect(transport);
+  console.error('NX MCP Server (Stdio) 已启动');
+}
+
+// ===== 入口：根据环境变量选择传输模式 =====
+const transportMode=process.env.MCP_TRANSPORT||'stdio';
+
+if(transportMode==='http'){
+  startHttp().catch((err)=>{
+    console.error('HTTP 启动失败:',err);
+    process.exit(1);
+  });
+}else{
+  startStdio().catch((err)=>{
+    console.error('启动失败:',err);
+    process.exit(1);
+  });
+}