Labsco
huitmj logo

Simple Animal Data MCP Server

from huitmj

A simple MCP server providing static information about animals like cats, dogs, and birds.

🔥✓ VerifiedFreeQuick setup
#cloud#devops#maps

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.

HTTP Server Version

For remote deployment, use the HTTP server version:

Running the HTTP Server

# Install HTTP dependencies
source venv/bin/activate
pip install -r requirements-http.txt

# Start the HTTP server
python http_server.py

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:

{
  "mcpServers": {
    "animal-data-http": {
      "command": "curl",
      "args": [
        "-X", "POST",
        "http://your-server.com:8000/mcp",
        "-H", "Content-Type: application/json",
        "-d", "@-"
      ]
    }
  }
}

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:

FROM python:3.11-slim
WORKDIR /app
COPY requirements-http.txt .
RUN pip install -r requirements-http.txt
COPY http_server.py .
EXPOSE 8000
CMD ["python", "http_server.py"]

Project Structure

simple/
├── server.py                      # Local MCP server (stdio transport)
├── http_server.py                 # HTTP MCP server (http transport)
├── requirements.txt               # Dependencies for local server
├── requirements-http.txt          # Dependencies for HTTP server
├── claude_desktop_config_http.json # HTTP server configuration example
├── venv/                          # Virtual environment (created after setup)
└── README.md                      # This documentation

Dependencies

  • fastmcp: Framework for building MCP servers with Python