Simple Animal Data MCP Server

A basic Model Context Protocol (MCP) server that provides static information about animals (cats, dogs, and birds) for use with Claude Desktop.

Installation

1. Clone or download this project

2. Create a virtual environment and install dependencies:

Usage

Running the Server

Available Tools

The server provides three tools:

• get_cat_info: Returns information about cats

• get_dog_info: Returns information about dogs

• get_bird_info: Returns information about birds

Claude Desktop Configuration

To use this MCP server with Claude Desktop, you need to create or edit the MCP configuration file:

Configuration File Location

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Creating the Configuration File

If the file doesn't exist, create it with the following content:

Alternative: Using Claude Desktop Settings

You can also configure this through Claude Desktop:

1. Open Claude Desktop

2. Go to Settings (Cmd+, on macOS or Ctrl+, on Windows)

3. Navigate to the "Developer" tab

4. Click "Edit Config" to open the configuration file

5. Add the MCP server configuration as shown above

Important:

• Replace /Users/james/Work/mcp/simple with your actual project directory path

• Restart Claude Desktop after making configuration changes

Example Usage in Claude Desktop

Once configured, you can ask Claude Desktop to use the animal data tools:

Example Queries

"Tell me about cats"

• Claude will use the get_cat_info tool and return: "Cats are independent, agile domestic animals known for their hunting skills and affectionate nature."

"What information do you have about dogs?"

• Claude will use the get_dog_info tool and return: "Dogs are loyal, social companion animals known for their intelligence and strong bond with humans."

"Give me bird information"

• Claude will use the get_bird_info tool and return: "Birds are feathered, winged animals capable of flight, known for their diverse songs and nesting behaviors."

"Compare cats, dogs, and birds"

• Claude will use all three tools to gather information and provide a comparison.

HTTP Server Version

For remote deployment, use the HTTP server version:

Running the HTTP Server

The server will start on http://localhost:8000 and accept MCP requests via HTTP POST to /mcp.

HTTP Server Configuration

For HTTP deployment, use the alternative configuration file claude_desktop_config_http.json:

Replace http://your-server.com:8000 with your actual server URL.

Deployment Options

• Local HTTP: Run on localhost:8000 for local HTTP testing

• Remote Server: Deploy to cloud services like Heroku, AWS, Google Cloud

• Docker: Containerize for easy deployment

Docker Deployment (Optional)

Create a Dockerfile:

Project Structure

Dependencies

• fastmcp: Framework for building MCP servers with Python

Troubleshooting

1. Server won't start: Ensure the virtual environment is activated and dependencies are installed

2. Claude Desktop can't connect: Verify the configuration file path and server path are correct

3. Tools not available: Restart Claude Desktop after updating the configuration file