金大哥 - mcp-image-placeholder MCP 详情

article

README

🚀 MCP 图像占位符服务器

MCP 图像占位符服务器是一个基于模型上下文协议 (MCP) 的服务器，它提供了一个实用工具，可从不同供应商处生成占位符图像，满足多样化的图像占位需求。

🚀 快速开始

本服务器能依据指定参数生成占位符图像，支持不同图像提供商，为您的项目快速提供合适的占位图像。使用前，需满足以下兼容性要求并完成安装配置。

✨ 主要特性

图像生成：根据指定参数生成占位符图像。
多提供商支持：支持两种图像提供商，分别为：
- placehold：提供简单的占位符图像。
- lorem-picsum：提供真实的图像作为占位符图像。
参数验证：对输入参数进行验证，确保生成图像的有效性。
直接可用：返回可以直接使用的图像 URL。

📦 安装指南

兼容性要求

Python 3.9+
uv 包管理器

安装步骤

克隆此仓库。
配置 MCP 服务器

💻 使用示例

基础用法

该服务器暴露一个工具 image_placeholder，可根据指定参数生成占位符图像的 URL。

# 生成 300x200 像素的占位符图片
url = image_placeholder(provider="placehold", width=300, height=200)

# 生成 500px 的正方形 lorem-picsum 图片
url = image_placeholder(provider="lorem-picsum", width=500)

参数说明

provider：要使用的图像提供商 (placehold 或 lorem-picsum)。
width：图像的宽度 (1 - 10000)。
height：图像的高度 (1 - 10000)。

返回值

生成的图像 URL 字符串。

📚 详细文档

配置

将此服务器连接到 Claude for Desktop

在 claude_desktop_config.json 中添加以下内容：

{
    "mcpServers": {
        "image-placeholder": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PROJECT",
                "run",
                "main.py"
            ]
        }
    }
}

重启 Claude for Desktop。

将此服务器连接到 Cursor

打开 Cursor 设置。
转到 功能 部分。
滚动到 MCP 服务器 部分。
点击 添加新的 MCP 服务器 按钮。
输入以下信息：
- 名称: image-placeholder
- 类型: command
- 服务器 URL: uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py
点击 添加 ↵ 按钮。

故障排除

如果工具未被检测到，请使用 uv 命令的绝对路径，例如：

/ABSOLUTE/PATH/TO/uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py

示例用法和输出 (Cursor)

提示

创建一个名为 "example" 的新目录和一个名为 output.html 的文件。

然后使用尾部 CSS 创建一个单页: https://unpkg.com/@tailwindcss/browser@4

显示一个漂亮的标题、内容和页脚，展示照片库。

将此保存到 output.html

输出示例

示例输出 (Cursor)

📄 许可证

本项目采用 MIT License 许可协议。

mcp-image-placeholder