Claude MCP Servers Collection

This repository contains a collection of Model Context Protocol (MCP) servers that extend Claude's capabilities by connecting it to external data sources and APIs. These servers allow Claude to access real-time information such as weather forecasts, movie data, and university information.

📋 Contents

• Weather Server: Get real-time weather forecasts and alerts using the National Weather Service API
• TMDB Movie Server: Access information about movies and TV shows via The Movie Database API
• Amity University Crawler: Extract and query information from Amity University Bengaluru's website
• Filesystem Server: Access and manage files on your local filesystem

🛠️ Prerequisites

Before setting up these MCP servers, make sure you have one of the following installed:

• Docker (recommended for easy setup)
  • Docker Desktop for Windows/Mac or Docker Engine for Linux
  • No other dependencies needed

OR if you prefer to run without Docker:

• Python 3.10+
• Git
• uv - A fast Python package installer and resolver

UV installation --> https://docs.astral.sh/uv/getting-started/installation/

🚀 Getting Started

Option 1: Using Docker (Recommended)

Step 1: Pull the Docker images

# Pull the Weather MCP server
docker pull kunalondock/mcp-weather:pythonv1

# Pull the TMDB Movie MCP server
docker pull kunalondock/mcp-movie:pythonv1

# Pull the Amity University MCP server
docker pull kunalondock/mcp-amity:pythonv1

# Pull the Filesystem MCP server
docker pull kunalondock/mcp-filesystem:pythonv1

Step 2: Configure Claude Desktop

Skip to the "Connecting to Claude Desktop" section below and use the Docker configuration.

Option 2: Manual Setup with Python

Step 1: Clone the Repository

# Clone the repository
git clone https://github.com/kunalworldwide/mcp_server_demo.git

# Navigate to the project directory
cd mcp_server_demo

Step 2: Install uv (if you haven't already)

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

curl -LsSf https://astral.sh/uv/install.py | python

After installation, restart your terminal to ensure the uv command is available.

Step 3: Set Up Each Server

Weather Server

# Navigate to the weather directory
cd weather

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Test the server
uv run weather.py

TMDB Movie Server

# Navigate to the tmdb directory
cd ../movieinfo/tmdb

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Open tmdb.py and replace YOUR_API_KEY_HERE with your TMDB API key
# You can get a free API key at https://www.themoviedb.org/settings/api

# Test the server
uv run tmdb.py

Amity University Crawler

# Navigate to the amity_crawler directory
cd ../../amity_crawler/amitycrawler

# Create a virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -r requirements.txt

# Test the server
uv run amity_crawler.py

🔌 Connecting to Claude Desktop

To connect these servers to Claude Desktop, you need to configure the Claude Desktop application.

Step 1: Open the Claude Desktop Config File

The configuration file is located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Roaming\Claude\claude_desktop_config.json

Create this file if it doesn't exist.

Step 2: Add Server Configurations

Option 1: Docker Configuration (Recommended)

Add the following to your claude_desktop_config.json file to use the pre-built Docker images:

{
    "mcpServers": {
        "weather": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "kunalondock/mcp-weather:pythonv1"
            ]
        },
        "tmdb": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "-e", "TMDB_API_KEY=46c00bf3aa4f426c510c4b3a026c29d6",
                "--rm",
                "kunalondock/mcp-movie:pythonv1"
            ]
        },
        "amity": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "--mount", "type=volume,src=amity-data,dst=/app/amity_data",
                "kunalondock/mcp-amity:pythonv1"
            ]
        },
        "filesystem": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "--mount", "type=bind,src=C:\\path\\to\\your\\files,dst=/projects/files",
                "kunalondock/mcp-filesystem:pythonv1",
                "/projects"
            ]
        }
    }
}

Notes:

• For the filesystem server, replace C:\\path\\to\\your\\files with the Windows path to the directory you want to make accessible to Claude
• On macOS/Linux, use the appropriate path format: /path/to/your/files
• The TMDB API key is pre-configured, but you can replace it with your own if needed

Option 2: Local Python Configuration

If you're not using Docker and have set up the servers locally with Python, use this configuration instead:

{
    "mcpServers": {
        "weather": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/weather",
                "run",
                "weather.py"
            ]
        },
        "tmdb": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/movieinfo/tmdb",
                "run",
                "tmdb.py"
            ]
        },
        "amity": {
            "command": "/path/to/your/uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp_server_demo/amitycrawler",
                "run",
                "amity_crawler.py"
            ]
        }
    }
}

Replace /path/to/your/uv with the actual path to your uv executable. You can find this by running:

which uv  # On macOS/Linux

(Get-Command uv).Source #On Windows

Also replace /absolute/path/to/mcp_server_demo with the absolute path to where you cloned the repository.

Step 3: Restart Claude Desktop

After saving the configuration file, restart Claude Desktop for the changes to take effect.

🔍 Testing the Servers

Once connected, you can test each server by asking Claude questions like:

• Weather Server:

  • "What's the weather like in Sacramento?"
  • "Are there any weather alerts in Texas?"

• TMDB Movie Server:

  • "What movies are currently popular?"
  • "Find me information about recent sci-fi movies."
  • "What TV shows are trending now?"

• Amity University Server:

  • "What courses are offered at Amity University Bengaluru?"
  • "Who are the faculty members in the Computer Science department?"
  • "Tell me about the admission process at Amity University."

• Filesystem Server:

  • "What files are in my Downloads folder?"
  • "Read the content of file.txt"
  • "Create a new directory called 'claude-files'"

🔧 Troubleshooting

If you encounter issues, try these solutions:

• Docker not running:

  • Make sure Docker Desktop or Docker Engine is running
  • Check if you can run a simple Docker container with docker run hello-world

• Docker images not found:

  • Verify you pulled the images with docker images | grep kunalondock
  • If not found, run the docker pull commands again

• Server not showing up in Claude Desktop:

  • Check your claude_desktop_config.json for syntax errors
  • Ensure the paths in your configuration are correct
  • Restart Claude Desktop completely

• Tool calls failing:

  • Check Claude's logs for errors
  • Verify Docker can access the necessary files and directories
  • Make sure you've configured the correct paths

• Checking Claude's logs:

  • macOS: Check log files in ~/Library/Logs/Claude/
  • Windows: Check log files in %APPDATA%\Claude\Logs\

🤝 Contributing

Feel free to enhance these servers or add new ones. Some ideas:

• Add more detailed weather information
• Expand the movie database to include reviews and recommendations
• Add more university information sources

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Anthropic for creating Claude and the Model Context Protocol
• The MCP documentation at modelcontextprotocol.io
• The National Weather Service and TMDB for their public APIs
• Amity University Bengaluru for educational information

Happy building with AI! 🚀