mcp-image-super-resolution

# 阿里云图像超分辨率 MCP 服务器 基于阿里云视觉智能开放平台的图像超分辨率 MCP 服务器，通过 AI 算法将图像放大 2-4 倍并显著提升清晰度。 ## ✨ 核心特性 - 🚀 **支持任意 URL**：无需上传到阿里云 OSS，支持任意可访问的 HTTP/HTTPS 图片链接 - 🔍 **AI 超分辨率**：智能算法放大图像同时保持细节清晰 - 📐 **灵活放大**：支持 2 倍、3 倍、4 倍放大 - 🎨 **格式支持**：输出 JPG 或 PNG 格式 - ⚙️ **质量可控**：可调节输出质量（1-100） - ⚡ **异步处理**：后台处理，不阻塞操作 ## 📦 安装 ### 方式 1：使用 uvx（推荐） 无需安装，直接运行： ```bash uvx mcp-image-super-resolution ``` ### 方式 2：通过 pip 安装 ```bash pip install mcp-image-super-resolution ``` ### 方式 3：从源码安装 ```bash git clone https://github.com/fengjinchao/mcp-image-super-resolution.git cd mcp-image-super-resolution pip install -e . ``` ## 🔑 配置阿里云凭证 ### 1. 获取 AccessKey 1. 访问 [阿里云 AccessKey 管理页面](https://ram.console.aliyun.com/manage/ak) 2. 创建 AccessKey ID 和 AccessKey Secret 3. 如使用 RAM 用户，需授予 `AliyunVIAPIFullAccess` 权限 ### 2. 配置环境变量 ```bash export ALIBABA_CLOUD_ACCESS_KEY_ID="你的 AccessKey ID" export ALIBABA_CLOUD_ACCESS_KEY_SECRET="你的 AccessKey Secret" ``` ## 🔧 在 MCP 客户端中配置 ### Claude Desktop 配置示例 编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`： ```json { "mcpServers": { "aliyun-image-super-resolution": { "command": "uvx", "args": ["mcp-image-super-resolution"], "env": { "ALIBABA_CLOUD_ACCESS_KEY_ID": "你的 AccessKey ID", "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "你的 AccessKey Secret" } } } } ``` ### Cline / Kiro 配置示例 在 `.cline/mcp_settings.json` 或 `.kiro/settings/mcp.json` 中添加： ```json { "mcpServers": { "aliyun-image-super-resolution": { "command": "mcp-image-super-resolution", "env": { "ALIBABA_CLOUD_ACCESS_KEY_ID": "你的 AccessKey ID", "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "你的 AccessKey Secret" }, "disabled": false, "autoApprove": [] } } } ``` ## 📖 使用指南 ### 工具 1: `submit_super_resolution_task` 提交图像超分辨率处理任务（自动轮询170秒）。 任务提交后会自动轮询最多170秒： - **如果在170秒内完成**：直接返回包含 `output_url` 的完整结果 - **如果超时未完成**：返回任务ID，提示用户稍后使用 `query_task_status` 手动查询 #### 参数 | 参数 | 类型 | 必填 | 默认值 | 说明 | |--…