yzsd-image 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +40 -36
- package/package.json +7 -3
package/README.md
CHANGED
|
@@ -1,25 +1,26 @@
|
|
|
1
1
|
# yzsd-image
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
YZSD AI 图片生成 MCP 服务器。通过 Model Context Protocol 使用 AI 生成和编辑图片。
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## 功能特性
|
|
6
6
|
|
|
7
|
-
-
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
- **3
|
|
11
|
-
- **MCP
|
|
7
|
+
- **文生图**: 根据文字描述生成图片
|
|
8
|
+
- **图生图**: 使用 AI 编辑现有图片
|
|
9
|
+
- **多种宽高比**: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4, 4:5
|
|
10
|
+
- **3 档分辨率**: 1K (快速), 2K (推荐), 4K (高质量)
|
|
11
|
+
- **MCP 兼容**: 支持 Claude Desktop、Cline 等所有 MCP 客户端
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## 安装使用
|
|
14
14
|
|
|
15
|
-
###
|
|
15
|
+
### 使用 npx (推荐)
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
无需安装!直接在 MCP 客户端中配置:
|
|
18
18
|
|
|
19
19
|
```json
|
|
20
20
|
{
|
|
21
21
|
"mcpServers": {
|
|
22
22
|
"yzsd-image": {
|
|
23
|
+
"type": "stdio",
|
|
23
24
|
"command": "npx",
|
|
24
25
|
"args": ["-y", "yzsd-image"],
|
|
25
26
|
"env": {
|
|
@@ -30,18 +31,19 @@ No installation needed! Configure directly in your MCP client:
|
|
|
30
31
|
}
|
|
31
32
|
```
|
|
32
33
|
|
|
33
|
-
###
|
|
34
|
+
### 全局安装
|
|
34
35
|
|
|
35
36
|
```bash
|
|
36
37
|
npm install -g yzsd-image
|
|
37
38
|
```
|
|
38
39
|
|
|
39
|
-
|
|
40
|
+
然后配置:
|
|
40
41
|
|
|
41
42
|
```json
|
|
42
43
|
{
|
|
43
44
|
"mcpServers": {
|
|
44
45
|
"yzsd-image": {
|
|
46
|
+
"type": "stdio",
|
|
45
47
|
"command": "yzsd-image",
|
|
46
48
|
"env": {
|
|
47
49
|
"YZSD_API_KEY": "your-api-key-here"
|
|
@@ -51,21 +53,22 @@ Then configure:
|
|
|
51
53
|
}
|
|
52
54
|
```
|
|
53
55
|
|
|
54
|
-
##
|
|
56
|
+
## 配置方法
|
|
55
57
|
|
|
56
58
|
### Claude Desktop
|
|
57
59
|
|
|
58
|
-
|
|
60
|
+
编辑 Claude Desktop 配置文件:
|
|
59
61
|
|
|
60
62
|
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
61
63
|
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
62
64
|
|
|
63
|
-
|
|
65
|
+
添加以下配置:
|
|
64
66
|
|
|
65
67
|
```json
|
|
66
68
|
{
|
|
67
69
|
"mcpServers": {
|
|
68
70
|
"yzsd-image": {
|
|
71
|
+
"type": "stdio",
|
|
69
72
|
"command": "npx",
|
|
70
73
|
"args": ["-y", "yzsd-image"],
|
|
71
74
|
"env": {
|
|
@@ -76,13 +79,14 @@ Add:
|
|
|
76
79
|
}
|
|
77
80
|
```
|
|
78
81
|
|
|
79
|
-
### Cline (VS Code
|
|
82
|
+
### Cline (VS Code 扩展)
|
|
80
83
|
|
|
81
|
-
|
|
84
|
+
在 Cline MCP 设置中添加:
|
|
82
85
|
|
|
83
86
|
```json
|
|
84
87
|
{
|
|
85
88
|
"yzsd-image": {
|
|
89
|
+
"type": "stdio",
|
|
86
90
|
"command": "npx",
|
|
87
91
|
"args": ["-y", "yzsd-image"],
|
|
88
92
|
"env": {
|
|
@@ -92,39 +96,39 @@ Add to your Cline MCP settings:
|
|
|
92
96
|
}
|
|
93
97
|
```
|
|
94
98
|
|
|
95
|
-
##
|
|
99
|
+
## 使用方法
|
|
96
100
|
|
|
97
|
-
|
|
101
|
+
配置完成后,在 MCP 客户端中使用:
|
|
98
102
|
|
|
99
|
-
###
|
|
103
|
+
### 生成图片
|
|
100
104
|
|
|
101
105
|
```
|
|
102
|
-
|
|
106
|
+
生成一张美丽的山景日落图片,16:9 宽高比,2K 分辨率
|
|
103
107
|
```
|
|
104
108
|
|
|
105
|
-
|
|
106
|
-
- `prompt` (
|
|
107
|
-
- `aspectRatio` (
|
|
108
|
-
- `size` (
|
|
109
|
-
- `outputPath` (
|
|
109
|
+
MCP 服务器提供 `generate_image` 工具,参数:
|
|
110
|
+
- `prompt` (必填): 图片描述
|
|
111
|
+
- `aspectRatio` (可选): 默认 "1:1"
|
|
112
|
+
- `size` (可选): "1K"、"2K" 或 "4K",默认 "2K"
|
|
113
|
+
- `outputPath` (可选): 保存路径
|
|
110
114
|
|
|
111
|
-
###
|
|
115
|
+
### 编辑图片
|
|
112
116
|
|
|
113
117
|
```
|
|
114
|
-
|
|
118
|
+
编辑 ./photo.jpg 这张图片,把背景改成海滩场景
|
|
115
119
|
```
|
|
116
120
|
|
|
117
|
-
|
|
118
|
-
- `inputPath` (
|
|
119
|
-
- `prompt` (
|
|
120
|
-
- `aspectRatio` (
|
|
121
|
-
- `outputPath` (
|
|
121
|
+
MCP 服务器提供 `edit_image` 工具,参数:
|
|
122
|
+
- `inputPath` (必填): 输入图片路径
|
|
123
|
+
- `prompt` (必填): 编辑描述
|
|
124
|
+
- `aspectRatio` (可选): 默认 "1:1"
|
|
125
|
+
- `outputPath` (可选): 保存路径
|
|
122
126
|
|
|
123
|
-
## API
|
|
127
|
+
## API 端点
|
|
124
128
|
|
|
125
|
-
|
|
129
|
+
MCP 服务器连接到: `https://token.1001xr.asia:8443`
|
|
126
130
|
|
|
127
|
-
##
|
|
131
|
+
## 开发
|
|
128
132
|
|
|
129
133
|
```bash
|
|
130
134
|
# Clone the repository
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "yzsd-image",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "1.0.2",
|
|
4
|
+
"description": "YZSD AI 图片生成 MCP 服务器 - 支持文生图和图生图编辑",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|
|
@@ -16,7 +16,11 @@
|
|
|
16
16
|
"mcp",
|
|
17
17
|
"ai",
|
|
18
18
|
"image-generation",
|
|
19
|
-
"yzsd"
|
|
19
|
+
"yzsd",
|
|
20
|
+
"图片生成",
|
|
21
|
+
"文生图",
|
|
22
|
+
"图生图",
|
|
23
|
+
"AI绘画"
|
|
20
24
|
],
|
|
21
25
|
"author": "",
|
|
22
26
|
"license": "MIT",
|