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
π οΈ Prerequisites
Before setting up these MCP servers, make sure you have the following installed:
- Python 3.10+
- Git
- uv - A fast Python package installer and resolver
π Getting Started
Step 1: Clone the Repository
# Clone the repository
git clone https://github.com/your-username/claude-mcp-servers.git
# Navigate to the project directory
cd claude-mcp-servers
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%\Claude\claude_desktop_config.json
Create this file if it doesn't exist.
Step 2: Add Server Configurations
Add the following to your claude_desktop_config.json
file:
{
"mcpServers": {
"weather": {
"command": "/path/to/your/uv",
"args": [
"--directory",
"/absolute/path/to/claude-mcp-servers/weather",
"run",
"weather.py"
]
},
"tmdb": {
"command": "/path/to/your/uv",
"args": [
"--directory",
"/absolute/path/to/claude-mcp-servers/movieinfo/tmdb",
"run",
"tmdb.py"
]
},
"amity": {
"command": "/path/to/your/uv",
"args": [
"--directory",
"/absolute/path/to/claude-mcp-servers/amity_crawler/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
where uv # On Windows
Also replace /absolute/path/to/claude-mcp-servers
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:
π Understanding the Code Structure
Directory Structure
.
βββ LICENSE
βββ README.md
βββ amitycrawler
β βββ README.md
β βββ amity_crawler.py
β βββ main.py
β βββ pyproject.toml
β βββ uv.lock
βββ movieinfo
β βββ tmdb
β βββ README.md
β βββ main.py
β βββ pyproject.toml
β βββ tmdb.py
β βββ uv.lock
βββ weather
βββ README.md
βββ main.py
βββ pyproject.toml
βββ uv.lock
βββ weather.py
Each server follows a similar structure:
- Main Server File (
weather.py
, tmdb.py
, amity_crawler.py
):
* Contains tool definitions and API integration logic
* Uses FastMCP to create and run the server
- Data Directory (for amity_crawler):
* Stores crawled and structured data
* Persists information between server sessions
- Dependencies :
* Each server uses the MCP SDK
* Additional libraries like httpx for API requests and BeautifulSoup for web scraping
π§ Troubleshooting
If you encounter issues, try these solutions:
π€ 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! π