lorem-ipsum-mcp
An lorem ipsum MCP server
Installation
Install the package globally with npm:
npm install -g lorem-ipsum-mcp
Or run directly with npx:
npx lorem-ipsum-mcp
Usage
The MCP server runs on stdio and is designed to be used as a Model Context Protocol server:
# Run directly if installed globally
lorem-ipsum-mcp
# Run with npx (no installation required)
npx lorem-ipsum-mcp
The HTTP server runs on http://localhost:3001 with the SSE endpoint at http://localhost:3001/sse.
Testing
This project includes comprehensive automated testing using GitHub Actions. For detailed testing information, see docs/TESTING.md.
Available Tools
image
Generate or fetch images from picsum.photos with various options.
Usage Examples:
- Get URL for a random 200x300 image:
image --width 200 --height 300 - Get image file for a random 200x300 image:
image --width 200 --height 300 --output file - Get URL for a specific, grayscaled, and blurred image:
image --id 870 --grayscale --blur 2 --width 200 --height 300 - List available images:
image --list --page 2 --limit 50 - Get metadata for a specific image:
image --info --id 0
Parameters:
--width(integer): The width of the image in pixels--height(integer): The height of the image in pixels--id(string): The ID of a specific image to retrieve--seed(string): A seed for generating a static random image--grayscale(boolean): Apply grayscale filter to the image--blur(integer 1-10): Apply blur filter with specified radius--format(jpg|webp): Image format--output(url|file): Output type - url returns string URL, file returns binary data (default: url)--list(boolean): Fetch list of available images--page(integer): Page number for list results--limit(integer): Number of results per page for list--info(boolean): Fetch metadata for a specific image