MCP Image Placeholder Server
MCP イメージプレースホルダーサーバー
これは、さまざまなプロバイダーからのプレースホルダー イメージを生成するためのツールを提供するモデル コンテキスト プロトコル (MCP) サーバーです。
特徴
サポートされているプロバイダーからプレースホルダー画像を生成します
2 つの画像プロバイダーをサポートします:
placehold: シンプルなプレースホルダー画像を提供しますlorem-picsum: 実際の画像をプレースホルダー画像として提供します
入力パラメータを検証する
すぐに使用できる画像の URL を返します
Related MCP server: Grok AI Image Generation MCP Server
要件
Python 3.9以上
uvパッケージマネージャー
インストール
このリポジトリをクローンする
使用法
サーバーは 1 つのツールを公開します:
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に接続するには:
claude_desktop_config.jsonに以下を追加します。{ "mcpServers": { "image-placeholder": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PROJECT", "run", "main.py" ] } } }デスクトップ版のClaudeを再起動
このサーバーを Cursor に接続するには:
カーソル設定を開く
FeaturesセクションへMCP ServersセクションまでスクロールしますAdd new MCP serverボタンをクリックします。次の情報を入力してください。
名前:
image-placeholderタイプ:
commandサーバー URL:
uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py
Add ↵ボタンをクリックします
トラブルシューティング
ツールが検出されない場合は、 uvコマンドの絶対パスを使用します。例:
/ABSOLUTE/PATH/TO/uv --directory /ABSOLUTE/PATH/TO/PROJECT run main.py使用例と出力(カーソル)
プロンプト:
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
出力:出力例 (カーソル)
ライセンス
Available Tools
1 toolimage_placeholderA
Generate a placeholder image based on a provider, width, and height.
Use this tool to generate a placeholder image for testing or development purposes.
Args:
provider: The provider to use for the image, must be either `placehold` or `lorem-picsum`.
width: The width of the image, must be a positive integer between 1 and 10000.
height: The height of the image, must be a positive integer between 1 and 10000.
| Name | Required | Description | Default |
|---|---|---|---|
| provider | Yes | ||
| width | Yes | ||
| height | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions the tool generates an image but lacks details on behavioral traits like output format (e.g., URL, binary data), error handling, rate limits, or authentication needs. This leaves gaps for an agent to understand how to use it effectively.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately sized and front-loaded, with the purpose stated first and parameter details organized in a clear 'Args' section. It avoids unnecessary fluff, though the second sentence slightly repeats the purpose without adding new value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no annotations and no output schema, the description is incomplete for a tool that generates output. It explains parameters well but omits details on what the tool returns (e.g., image URL or data), which is critical for an agent to use it correctly. This gap reduces completeness despite good parameter coverage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 0%, but the description compensates fully by explaining all three parameters in the 'Args' section: provider options, width/height ranges, and constraints. This adds crucial meaning beyond the bare schema, making parameters clear and actionable.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the specific action ('Generate a placeholder image') and resource ('based on a provider, width, and height'), with the second sentence reinforcing the purpose for testing/development. It uses precise verbs and distinguishes the tool's function without tautology.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context for when to use the tool ('for testing or development purposes'), which helps guide the agent. However, since there are no sibling tools mentioned, it cannot differentiate from alternatives, though this is not a flaw given the context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
- First observed
image_placeholder
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap with other tools. The tool's purpose is clearly defined and distinct by default.
The single tool name 'image_placeholder' follows a clear and consistent verb_noun pattern. Since there is only one tool, naming consistency is inherently perfect.
A single tool for an image placeholder server feels thin and limited in scope. While it serves a specific purpose, it lacks related operations like listing available providers or generating images with additional parameters, making it borderline too few for practical use.
The tool covers the core functionality of generating placeholder images with basic parameters. However, there are notable gaps, such as no tools for retrieving image metadata, managing providers, or handling errors beyond parameter validation, which limits the server's utility.
Maintenance
Related MCP Connectors
Generate deterministic placeholder image URLs and packs for docs, staging, testing, and AI agents.
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
AI-native mock API server with MCP. Create REST/SOAP mocks from Claude, Cursor, or Windsurf.
Mock REST APIs, fake OAuth2/OIDC provider, uptime monitors + heartbeats, live badge/QR images.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis server provides tools for uploading images and videos directly to Cloudinary using Claude/Cline, facilitating resource management with customizable options like resource type and public ID.114 npm10MIT
- FlicenseNot gradedqualityDmaintenanceA server that connects to the xAI/Grok image generation API, allowing users to generate images from text prompts with support for multiple image generation and different response formats.-
- AlicenseCqualityDmaintenanceA server that accepts image URLs and analyzes their content using GPT-4-turbo, enabling Claude AI assistants to understand and describe images through natural language.211 npm8MIT
- FlicenseBqualityDmaintenanceA Model Context Protocol server that enables image generation and retrieval from picsum.photos with customizable parameters like dimensions, filters, and output formats.1-