使用说明

项目简介

Image Placeholder MCP服务器是一个实现了 Model Context Protocol (MCP) 的后端服务，专注于为大型语言模型 (LLM) 提供生成占位图像 URL 的能力。它通过简单的工具接口，允许 LLM 客户端根据需求快速获取占位图像，用于各种开发和测试场景，例如网页布局、内容占位等。

主要功能点

按需生成占位图像 URL: 提供 'image_placeholder' 工具，LLM 可以调用此工具并指定图像的尺寸和提供商，服务器会返回对应的占位图像 URL。
支持多种占位图像提供商: 目前支持 'placehold.co' 和 'lorem-picsum.photos' 两个常用的占位图像服务，用户可以根据需要选择。
参数校验: 对用户输入的图像尺寸参数进行校验，确保参数有效，避免因参数错误导致服务异常。
易于集成: 遵循 MCP 协议标准，可以方便地与支持 MCP 协议的 LLM 客户端（如 Claude for Desktop, Cursor 等）集成。

安装步骤

克隆仓库: 将 GitHub 仓库 'https://github.com/husniadil/mcp-image-placeholder' 克隆到本地。

git clone https://github.com/husniadil/mcp-image-placeholder
cd mcp-image-placeholder

安装依赖: 推荐使用 'uv' 包管理器进行依赖安装。如果尚未安装 'uv'，请先安装 'uv'。然后在项目根目录下，使用 'uv' 安装项目依赖（虽然此项目本身没有requirements.txt等依赖描述文件，但根据README，可能需要确保Python 3.9+ 环境以及安装 'uv' 包管理器）。

# 假设 uv 已安装
# 本项目可能不需要额外安装项目依赖，但如果后续有需要，可以使用 uv 安装
# uv pip install -r requirements.txt  (如果项目有 requirements.txt 文件)

服务器配置

要将此 MCP 服务器连接到 MCP 客户端，您需要配置客户端以启动此服务器。以下是针对 Claude for Desktop 和 Cursor 的配置示例。

Claude for Desktop 配置

在 'claude_desktop_config.json' 文件中，添加以下配置到 'mcpServers' 字段中：

{
    "mcpServers": {
        "image-placeholder": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PROJECT",  // 将 "/ABSOLUTE/PATH/TO/PROJECT" 替换为项目在您电脑上的绝对路径
                "run",
                "main.py"
            ]
        }
    }
}

配置参数说明:

'"image-placeholder"': 服务器名称，可以自定义，用于在客户端中标识该服务器。
'"command": "uv"': 启动服务器的命令，这里使用 'uv' 命令。
'"args"': 传递给 'uv' 命令的参数列表。
- '"--directory"': 指定项目目录。
- '"/ABSOLUTE/PATH/TO/PROJECT"': 请务必替换为 'mcp-image-placeholder' 仓库在您电脑上的绝对路径。例如 '/Users/yourusername/mcp-image-placeholder' (macOS/Linux) 或 'C:\Users\YourUsername\mcp-image-placeholder' (Windows)。
- '"run"': 'uv run' 命令用于运行 Python 脚本。
- '"main.py"': 指定要运行的 Python 脚本为 'main.py'，即服务器的入口文件。

Cursor 配置

在 Cursor 的设置 (Settings) 中，找到 'Features' -> 'MCP Servers' 部分，点击 "Add new MCP server" 添加新的 MCP 服务器。

Name: 'image-placeholder' (服务器名称，与 Claude 配置保持一致，方便管理)
Type: 'command' (指定服务器类型为命令启动)
Server URL: 'uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py' (启动服务器的完整命令，同样需要将 '/ABSOLUTE/PATH/TO/PROJECT' 替换为实际的项目绝对路径)

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您就可以使用 'image_placeholder' 工具来生成占位图像 URL 了。

例如，在 Claude 或 Cursor 中，您可以指示 LLM 执行类似如下的操作：

"请使用 'image_placeholder' 工具生成一个宽度为 400px，高度为 300px，提供商为 'lorem-picsum' 的占位图像，并将 URL 返回给我。"

LLM 客户端会将您的指令转换为 MCP 请求发送给 Image Placeholder MCP 服务器。服务器执行 'image_placeholder' 工具，根据您指定的参数，生成对应的占位图像 URL，并通过 MCP 响应返回给 LLM 客户端。LLM 客户端就可以在后续的对话或任务中使用这个 URL 了。

'image_placeholder' 工具参数：

'provider': 字符串类型，指定占位图像提供商，可选值： '"placehold"' 或 '"lorem-picsum"'。
'width': 整数类型，指定图像宽度，范围 1-10000 (像素)。
'height': 整数类型，指定图像高度，范围 1-10000 (像素)。

'image_placeholder' 工具返回值：

字符串类型，返回生成的占位图像 URL。

关键词