mclans-image-mcp
# mclans-image-mcp
异步生图 MCP Server — 提交即忘,图片自动下载到本地。
## 配置 MCP
### Claude Code
编辑 `~/.claude/settings.json`:
```json
{
"mcpServers": {
"mclans-image": {
"command": "npx",
"args": ["-y", "github:YupegLV/mclans-create-image-mcp"],
"env": {
"IMAGE_API_KEY": "sk-xxxxx"
}
}
}
}
```
### Claude Desktop
编辑配置文件:
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"mclans-image": {
"command": "npx",
"args": ["-y", "github:YupegLV/mclans-create-image-mcp"],
"env": {
"IMAGE_API_KEY": "sk-xxxxx"
}
}
}
}
```
### Cursor / VS Code
在设置中搜索 `MCP`,添加服务器配置:
```json
{
"mcp": {
"servers": {
"mclans-image": {
"command": "npx",
"args": ["-y", "github:YupegLV/mclans-create-image-mcp"],
"env": {
"IMAGE_API_KEY": "sk-xxxxx"
}
}
}
}
}
```
### API Key 配置说明
| 方式 | 说明 |
|------|------|
| 环境变量 `IMAGE_API_KEY` | 推荐,在 MCP 配置的 `env` 中传入 |
| 命令行参数 | 在 `args` 中添加 `--api-key=sk-xxxxx` |
| 配置文件 | 手动创建 `~/.mclans-image-mcp/config.json` |
首次通过环境变量或命令行参数启动后,配置会自动持久化到 `~/.mclans-image-mcp/config.json`,后续无需重复配置。
如需自定义 API 地址,可添加环境变量 `IMAGE_API_BASE_URL` 或命令行参数 `--api-base-url=https://your-api-url`。
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: generating images, generating turnaround (multi-view), generating videos, checking task status, and listing tasks. There is no overlap or ambiguity.
Tool names follow a consistent verb_noun pattern in snake_case (e.g., generate_image, check_task, list_tasks). The only minor deviation is 'generate_turnaround' where 'turnaround' is a specific noun, but still fits the pattern.
5 tools is well-scoped for an image and video generation server. It covers submission (3 generation types), status checking, and listing, without being overwhelming or too sparse.
The tool surface covers core workflows: submit generation tasks (image, turnaround, video), check results, and list tasks. However, there are no tools for cancelling or deleting tasks, which are minor gaps.