@dennisk2025/random-fox-image
v1.0.0
Published
Fetches random images of adorable foxes via MCP server API integration.
Readme
random-fox-image MCP Server
Fetches a random image of a fox to delight and entertain users with adorable fox pictures. Provides an MCP-compatible API integration, ideal for tools like Claude Desktop and other model context hosts.
Features
- Instantly fetches a random fox image from https://randomfox.ca/floof/
- Simple, robust API tool:
get_random_fox_image - CLI and Claude Desktop integration support
Installation
Using npx (recommended):
npx @dennisk2025/random-fox-imageOr install globally:
npm install -g @dennisk2025/random-fox-imageAdding to Claude Desktop
To use this MCP server in Claude Desktop, add the following to your claude_desktop_config.json file:
{
"mcpServers": {
"random-fox-image": {
"command": "npx",
"args": ["@dennisk2025/random-fox-image"]
}
}
}Config file locations:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add or merge this block under
"mcpServers"in your configuration file.
Usage & Example
After adding to Claude Desktop (or running via CLI), this MCP provides the following tool:
Tool: get_random_fox_image
Fetches a random image of a fox and returns its image URL for sharing or enjoyment.
Parameters:
- none
Example request:
{
"tool_name": "get_random_fox_image",
"arguments": {}
}Example response:
{
"image_url": "https://randomfox.ca/images/123.jpg",
"attribution_url": "https://randomfox.ca/"
}In Claude Desktop
- Invoke the tool by searching for its name and click to run; result includes a direct fox image link!
Tools Reference
| Tool Name | Description | Parameters | |----------------------|----------------------------------------------------------------------|------------| | get_random_fox_image | Fetches a random image of a fox from a public API and returns the image URL for sharing or enjoyment. | none |
See Also
- randomfox.ca — All images are sourced from this public API.
Enjoy the foxes! 🦊
