@chinchillaenterprises/mcp-dog-fetcher

MCP Dog Fetcher

An MCP server that fetches random dog images from the Dog CEO API and can save them to your local filesystem.

Features

• Fetch random dog images
• Fetch images of specific dog breeds
• List all available dog breeds
• Download and save images to local filesystem

Installation

npm install -g @chinchillaenterprises/mcp-dog-fetcher

Configuration

For Claude Code

Add to your Claude Code configuration using the CLI:

claude mcp add dog-fetcher -- npx @chinchillaenterprises/mcp-dog-fetcher

Or manually edit ~/.claude.json:

{
  "mcpServers": {
    "dog-fetcher": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@chinchillaenterprises/mcp-dog-fetcher"]
    }
  }
}

For Claude Desktop

Edit your claude_desktop_config.json:

{
  "mcpServers": {
    "dog-fetcher": {
      "command": "npx",
      "args": ["-y", "@chinchillaenterprises/mcp-dog-fetcher"]
    }
  }
}

Available Tools

1. fetch_random_dog

Fetches a random dog image URL.

Parameters:

• breed (optional): Specific breed to fetch (e.g., 'shiba', 'husky', 'retriever-golden')

Example usage:

"Get me a random dog image"
"Show me a random golden retriever"
"Fetch a shiba inu picture"

2. fetch_dog_breeds

Returns a list of all available dog breeds.

Example usage:

"What dog breeds are available?"
"List all dog breeds"

3. save_image

Downloads and saves an image from a URL to your local filesystem.

Parameters:

• url (required): The URL of the image to download
• filepath (required): Where to save the image (including filename)

Example usage:

"Save this dog image to ~/Pictures/cute-dog.jpg"
"Download the image and save it as ./dogs/my-dog.png"

Common Workflows

Save a random dog to your desktop

"Fetch a random dog and save it to ~/Desktop/random-dog.jpg"

Create a collection of specific breed

"Get 5 different corgi images and save them to ./corgi-collection/"

Browse breeds and pick one

"Show me all available breeds"
"Now get me a random image of a samoyed"
"Save it to ./favorite-dogs/fluffy.jpg"

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start