# @bashcat/ai-image-chat-mcp 中文文档

规范地址：https://npmcn.com/package/%40bashcat/ai-image-chat-mcp/

版本：3\.0\.0
npm 元数据更新时间：2026-04-12T05:51:46.728Z
中文译文更新时间：2026-11-07T17:52:37.271Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bashcat/ai-image-chat-mcp
原文对照：https://npmcn.com/package/%40bashcat/ai-image-chat-mcp/?lang=original
项目主页：https://bashcat.net/
源码仓库：https://github.com/bashcat/ai-image-chat-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：57.4 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：5 个
- 首次发布：2025-06-28T18:07:29.793Z
- 最新版本发布：2026-04-12T05:51:46.621Z
- 近 30 天下载量：3613（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 1 个）

## 中文简介

MCP服务器用于AI图像生成,视频生成和聊天完成,支持包括通义万祥在内的多家AI供应商

## 安装

```sh
npm install @bashcat/ai-image-chat-mcp
```

也可以使用：`pnpm add @bashcat/ai-image-chat-mcp`、`yarn add @bashcat/ai-image-chat-mcp`、`bun add @bashcat/ai-image-chat-mcp`

## README

# AI Image Chat MCP 工具

這是一個通用的 AI 圖片生成和對話完成 Model Context Protocol (MCP) 工具，支持多種 AI 服務提供商。

## 功能特性

-   🖼️ **圖片生成**: 使用 AI 模型生成圖片
-   💬 **對話完成**: 使用 AI 模型進行智能對話
-   🚀 **阿里雲 DashScope**: 支援阿里雲 DashScope 高品質文生圖 API
-   📁 **自動保存**: 生成的圖片會自動下載並保存到指定目錄
-   📝 **智能命名**: 檔名根據用戶的 prompt 自動生成
-   🔐 **安全配置**: API 密鑰安全保存在 `.env` 文件中
-   🎛️ **自定義提示**: 支持自定義系統提示詞，如未提供則使用預設值

## 安裝與設置

### 1\. 安裝依賴

```bash
npm install
```

### 2\. 配置環境變數

編輯 `.env` 文件，設置你的 API 密鑰：

```env
AI_API_KEY=your_api_key_here
AI_API_BASE_URL=https://api.laozhang.ai/v1
AI_IMAGE_SAVE_PATH=/path/to/your/images/directory
ALI_API_KEY=your_ali_api_key_here
# 或者使用
DASHSCOPE_API_KEY=your_dashscope_api_key_here
```

**環境變數說明：**

-   `AI_API_KEY`: 您的 AI API 密鑰（必須）
-   `AI_API_BASE_URL`: API 基礎 URL（可選，預設為 `https://api.laozhang.ai/v1`）
-   `AI_IMAGE_SAVE_PATH`: 圖片保存路徑（可選，預設為 `~/generated_images`）
-   `ALI_API_KEY`: 阿里雲 DashScope API 密鑰（使用阿里雲功能時必須）
-   `DASHSCOPE_API_KEY`: 阿里雲 DashScope API 密鑰的別名（與 ALI\_API\_KEY 二選一）

**支持的 API 服務商：**

-   老張 AI: `https://api.laozhang.ai/v1`
-   阿里雲 DashScope: `https://dashscope.aliyuncs.com/api/v1`
-   OpenAI: `https://api.openai.com/v1`
-   其他 OpenAI 兼容的 API 服務

### 3\. 編譯項目

```bash
npm run build
```

### 4\. 啟動服務

```bash
npm start
```

## MCP (Model Context Protocol) 設置

### 在 Claude Desktop 中使用

編輯您的 Claude Desktop 配置文件 (`~/Library/Application Support/Claude/claude_desktop_config.json`)：

```json
{
  "mcpServers": {
    "ai-image-chat-mcp": {
      "command": "npx",
      "args": ["-y", "@bashcat/ai-image-chat-mcp"],
      "env": {
        "AI_API_KEY": "your_api_key_here",
        "AI_API_BASE_URL": "https://api.laozhang.ai/v1",
        "AI_IMAGE_SAVE_PATH": "~/Pictures/AI_Generated_Images",
        "ALI_API_KEY": "your_ali_api_key_here"
      }
    }
  }
}
```

### 在 VS Code 中使用

編輯您的 VS Code 設置 (`settings.json`)：

```json
{
  "mcp": {
    "servers": {
      "ai-image-chat-mcp": {
        "command": "npx",
        "args": ["-y", "@bashcat/ai-image-chat-mcp"],
        "env": {
          "AI_API_KEY": "your_api_key_here",
          "AI_API_BASE_URL": "https://api.laozhang.ai/v1",
          "AI_IMAGE_SAVE_PATH": "~/Pictures/AI_Generated_Images",
          "ALI_API_KEY": "your_ali_api_key_here"
        }
      }
    }
  }
}
```

### 環境變數配置

| 環境變數 | 必需 | 預設值 | 說明 |
| --- | --- | --- | --- |
| `AI_API_KEY` | ✅ | \- | 您的 AI API 密鑰 |
| `AI_API_BASE_URL` | ❌ | `https://api.laozhang.ai/v1` | API 基礎 URL |
| `AI_IMAGE_SAVE_PATH` | ❌ | `~/generated_images` | 圖片保存路徑 |
| `ALI_API_KEY` | ❌ | \- | 阿里雲 DashScope 密鑰 |
| `DASHSCOPE_API_KEY` | ❌ | \- | 阿里雲密鑰的別名 |

### 圖片保存功能

-   🖼️ **自動保存**: 生成的圖片會自動保存到指定目錄
-   📁 **動態路徑**: 通過 `AI_IMAGE_SAVE_PATH` 環境變數自定義保存路徑
-   📝 **智能命名**: 檔名根據 prompt 自動生成，例如：`台灣男性工程師-2025-09-21T07-15-30-123Z.jpg`
-   📂 **目錄創建**: 如果指定目錄不存在，會自動創建
-   🔄 **格式轉換**: 支援 base64 圖片解碼和格式轉換
-   🎨 **多格式支援**: 支援 JPG、PNG、WebP 輸出格式
-   🏠 **友好顯示**: 路徑顯示使用 `~` 代替 home 目錄，更簡潔易讀

#### 圖片保存路徑設定範例：

```bash
# 預設保存到使用者主目錄
export AI_IMAGE_SAVE_PATH="~/generated_images"

# 自定義絕對路徑
export AI_IMAGE_SAVE_PATH="/Users/username/Pictures/AI_Images"

# 相對於專案的路徑
export AI_IMAGE_SAVE_PATH="./images"
```

## 可用工具

### 1\. generate\_image

使用老張 AI 生成圖片的工具。

**參數:**

-   `prompt` (必需): 圖片生成的提示詞
-   `system_prompt` (可選): 系統提示詞，預設為 "You are a helpful assistant that generates images."
-   `model` (可選): 模型名稱，可選 "gpt-image-1" 或 "gpt-4o-image"，預設為 "gpt-4o-image"
-   `output_format` (可選): 輸出圖片格式，可選 "jpg"、"jpeg"、"png"、"webp"，預設為 "jpg"

**範例:**

```json
{
  "prompt": "生成一張卡通風格的熊貓宇航員圖片，背景是星空",
  "system_prompt": "You are a creative image generator.",
  "model": "gpt-4o-image",
  "output_format": "png"
}
```

或使用新的 Gemini 模型（v2.3.4+ 支援 base64 圖片自動保存）：

```json
{
  "prompt": "賽博朋克風格的未來城市夜景",
  "model": "gemini-2.5-flash-image-preview",
  "aspect_ratio": "16:9",
  "n": 2
}
```

**⭐ Gemini 模型特色功能**：

-   支援 base64 格式圖片自動保存到本地檔案
-   高速生成，品質優秀
-   支援多種輸出格式（jpg, png, webp）

### 2\. tongyi\_wanxiang\_generate\_image (推薦)

使用通義萬相文生圖完整生圖流程。

**參數:**

-   `prompt` (必需): 正向提示詞
-   `model` (可選): 模型選擇，可選值：
    -   `wanx2.1-t2i-turbo`: 速度快 (0.14元/張)
    -   `wanx2.1-t2i-plus`: 品質高 (0.20元/張)
    -   `wanx2.0-t2i-turbo`: 性價比高，擅長人像 (0.04元/張)
-   `negative_prompt` (可選): 反向提示詞，預設為 "人物"
-   `size` (可選): 圖像分辨率，預設為 "1024\*1024"
-   `n` (可選): 生成圖片數量 (1-4)，預設為 1
-   `seed` (可選): 隨機數種子
-   `prompt_extend` (可選): 是否開啟智能改寫，預設為 true
-   `watermark` (可選): 是否添加水印，預設為 false
-   `output_format` (可選): 輸出格式，預設為 "jpg"
-   `max_wait_minutes` (可選): 最大等待時間（分鐘），預設為 5

**範例:**

```json
{
  "prompt": "一隻可愛的橘貓坐在櫻花樹下，春天的陽光灑在它身上",
  "model": "wanx2.1-t2i-plus",
  "size": "1024*1024",
  "output_format": "png"
}
```

### 3\. tongyi\_wanxiang\_create\_task

創建通義萬相文生圖任務。

### 4\. tongyi\_wanxiang\_query\_task

查詢通義萬相文生圖任務結果。

### 5\. chat\_completion

進行對話的工具。

**參數:**

-   `message` (必需): 用戶訊息
-   `system_prompt` (可選): 系統提示詞，預設為 "You are a helpful assistant."
-   `model` (可選): 模型名稱，預設為 "gpt-4"

**範例:**

```json
{
  "message": "請幫我寫一首關於春天的詩",
  "system_prompt": "You are a professional poet.",
  "model": "gpt-4"
}
```

## API 參考

本工具使用老張 AI 的聊天完成 API：

```
POST https://api.laozhang.ai/v1/chat/completions
```

**請求格式:**

```json
{
  "model": "gpt-image-1",
  "messages": [
    { "role": "system", "content": "系統提示詞" },
    { "role": "user", "content": "用戶訊息" }
  ]
}
```

## 開發

### 開發模式

```bash
npm run dev
```

這會啟動 TypeScript 編譯器的監聽模式，當你修改代碼時會自動重新編譯。

### 項目結構

```text
laozhang_mcp/
├── src/
│   └── index.ts          # 主要服務器代碼
├── dist/                 # 編譯後的輸出
├── .env                  # 環境變數配置
├── package.json          # 項目配置
├── tsconfig.json         # TypeScript 配置
└── README.md            # 說明文檔
```

## 通義萬相文生圖集成

本工具支援阿里雲通義萬相文生圖V2版本的三種模型。詳細說明請參考：

-   [通義萬相使用指南](https://npmcn.com/package/%40bashcat/ai-image-chat-mcp/TONGYI_WANXIANG_GUIDE.md) - 新版詳細指南
-   [DASHSCOPE\_INTEGRATION.md](https://npmcn.com/package/%40bashcat/ai-image-chat-mcp/DASHSCOPE_INTEGRATION.md) - 原版集成說明

### 模型對比

| 模型 | 特點 | 價格 | 適用場景 |
| --- | --- | --- | --- |
| wanx2.1-t2i-turbo | 速度快 | 0.14元/張 | 快速生成 |
| wanx2.1-t2i-plus | 品質高 | 0.20元/張 | 精細作品 |
| wanx2.0-t2i-turbo | 性價比高 | 0.04元/張 | 人像專長 |

### 快速開始

1.  在 [阿里雲百炼平台](https://dashscope.aliyuncs.com/) 獲取 API Key
2.  設置環境變數 `ALI_API_KEY`
3.  使用 `tongyi_wanxiang_generate_image` 工具生成圖片

## 注意事項

1.  請確保你有有效的 AI API 密鑰
2.  使用阿里雲功能需要設置 `ALI_API_KEY` 或 `DASHSCOPE_API_KEY`
3.  不要將 `.env` 文件提交到版本控制系統
4.  圖片生成可能需要較長時間，請耐心等待
5.  API 有使用限制，請適度使用

## 許可證

MIT License

## 常见问题

### @bashcat/ai-image-chat-mcp 是什么？

MCP服务器用于AI图像生成,视频生成和聊天完成,支持包括通义万祥在内的多家AI供应商

### 如何安装 @bashcat/ai-image-chat-mcp？

在项目目录运行 npm install @bashcat/ai-image-chat-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ai-image-chat-mcp，可以用 npx ai-image-chat-mcp 直接运行。

### @bashcat/ai-image-chat-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bashcat/ai-image-chat-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @bashcat/ai-image-chat-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bashcat/ai-image-chat-mcp 可以商用吗？

@bashcat/ai-image-chat-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bashcat/ai-image-chat-mcp 的下载量有多少？

根据 npm 官方下载统计，@bashcat/ai-image-chat-mcp 在 2026/10/08 – 2026/11/06 这 30 天内被下载 3,613 次，日均约 120 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bashcat/ai-image-chat-mcp 还在维护吗？

最新版本 3\.0\.0 发布于 2026/04/12（6 个月前）；至今共发布 27 个版本，其中过去 12 个月发布了 1 个；首次发布于 2025/06/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。