MCP Image Placeholder Server

MCP 图像占位符服务

这是一个模型上下文协议（MCP）服务，可通过不同的提供方生成占位图像。

功能

• 使用受支持的提供方生成占位图像
• 支持两种图像提供方：
  • placehold：提供简单的占位图像
  • lorem-picsum：提供用作占位图像的真实图像
• 验证输入参数
• 返回可立即使用的图像 URL

要求

• Python 3.9+
• uv 包管理器

安装

1. 克隆此仓库
2. 设置 MCP 服务的配置

用法

该服务提供一个工具：

image_placeholder

根据指定参数生成占位图像 URL。

参数：

• provider：要使用的图像提供方（placehold 或 lorem-picsum）
• width：图像宽度（1-10000）
• height：图像高度（1-10000）

返回值：

• 生成的图像 URL 字符串

用法示例：

# Generate a 300x200 placeholder image
url = image_placeholder(provider="placehold", width=300, height=200)

# Generate a 500px square lorem-picsum image
url = image_placeholder(provider="lorem-picsum", width=500)

配置

将此服务连接到 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. 前往 Features 部分
3. 向下滚动到 MCP Servers 部分
4. 点击 Add new MCP server 按钮
5. 输入以下信息：
   • 名称：image-placeholder
   • 类型：command
   • 服务 URL：uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py
6. 点击 Add ↵ 按钮

故障排除

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

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

用法示例和输出（Cursor）

提示词：

Create a new directory named "example" and a file named output.html.

Then create a single modern looking page using tailwindcss: https://unpkg.com/@tailwindcss/browser@4

Show a nice header, content, and footer, showing a photo gallery.

Save this into output.html

输出： 示例输出（Cursor）

许可证

MIT 许可证