Claude MCP Servers Collection

🚀 Clara MCP Project Documentation

This documentation supports the Model Context Protocol (MCP) example project for Claude, demonstrating how to extend Claude's capabilities through Docker and local Python scripts. We offer four servers: Weather, TMDB Movies, Amity University Information, and File System Access.

📦 Installation

1. Docker

• Installation Guide:

  • Docker Official Documentation

• Verify Installation:

  docker --version
  

2. UV Command Tool

• Get UV:
  • Use the Docker image: docker pull ghcr.io/anthropic/uv-cli:latest
  • After installation, check the path using the following commands:

    which uv # macOS/Linux
    (Get-Command uv).Source # Windows
    

🚀 Quick Start

Configure Servers with Docker

Edit the claude_desktop_config.json file and add the following configuration:

{
  "mcpServers": {
    "weather": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-weather:latest"
      ]
    },
    "tmdb": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-tmdb:latest"
      ]
    },
    "amity-university": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-amity:latest"
      ]
    },
    "file-system": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--mount",
        "type=bind,src=/path/to/files,dst=/projects/files",
        "kunal/mcp-file-system:latest",
        "/projects"
      ]
    }
  }
}

Configure Servers with Local Python Scripts

Edit the claude_desktop_config.json file and add the following configuration:

{
  "mcpServers": {
    "weather": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-weather",
        "run",
        "weather.py"
      ]
    },
    "tmdb": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-tmdb",
        "run",
        "tmdb.py"
      ]
    },
    "amity-university": {
      "command": "$(which uv)",
      "args": [
        "--directory",
        "/path/to/mcp-amity",
        "run",
        "amity_crawler.py"
      ]
    }
  }
}

📚 Complete Configuration Example

{
  "mcpServers": {
    "weather": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-weather:latest"
      ]
    },
    "tmdb": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-tmdb:latest"
      ]
    },
    "amity-university": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "kunal/mcp-amity:latest"
      ]
    },
    "file-system": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--mount",
        "type=bind,src=/path/to/files,dst=/projects/files",
        "kunal/mcp-file-system:latest",
        "/projects"
      ]
    }
  }
}

💻 Testing the Servers

• Weather Server:

  • Example query: "What's the current weather in Sacramento?"

• TMDB Movie Server:

  • Example query: "Which movies are currently in theaters?"

• Amity University Server:

  • Example query: "What courses are offered at the Bengaluru campus?"

• File System Server:

  • Example query: "What files are in the Downloads folder?"

🔧 Troubleshooting

Common Issues

1. Docker Not Running

   • Ensure Docker Desktop or the Docker engine is started.
   • Test container operation using docker run hello-world.

2. Image Not Found

   • Check if the image exists: docker images | grep kunal/mcp-
   • Pull the image again if necessary.

👥 Project Contributors

• Kunal Chhabra (@kunalc)

This documentation provides a detailed guide for extending Claude's capabilities. By combining Docker and local scripts, you can easily add custom servers to enhance the interaction experience.