🚀 MCP 图像占位符服务器

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

🚀 快速开始

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

✨ 主要特性

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

📦 安装指南

兼容性要求

• Python 3.9+
• uv 包管理器

安装步骤

1. 克隆此仓库。
2. 配置 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

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

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

2. 重启 Claude for Desktop。

将此服务器连接到 Cursor

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

故障排除

如果工具未被检测到，请使用 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 许可协议。