This MCP server is a Python-based implementation built with the MCP SDK. It exposes three main tool areas: Note Management, Weather Information, and News Search. Note Management lets you add notes, read existing notes, fetch the latest note, and generate a concise summary of stored notes. Weather Information retrieves current conditions for a specified city by calling WeatherAPI, with the API key provided via a .env file. News Search uses Brave Search to perform queries and return relevant results. The server reads API keys from a .env file, so ensure WEATHER_API_KEY and BRAVE_API_KEY are properly set before starting. You interact with the server through the MCP framework, using the provided CLI commands (mcp install and mcp dev) to deploy and run the server locally or in your environment.

Prerequisites:

• Python 3.12+ installed
• A Python virtual environment (recommended) or uv/poetry setup if you prefer alternative tooling

Step-by-step installation:

1. Clone the repository git clone https://github.com/sourangshupal/Build-Custom-MCP-Servers cd Build-Custom-MCP-Servers

2. Set up a virtual environment and install dependencies

   Using venv

   python -m venv .venv source .venv/bin/activate # macOS/Linux .venv\Scripts\activate # Windows

   Install requirements

   pip install -r requirements.txt

   If you use uv (optional, as in the original setup script):

   uv sync uv lock

3. Configure environment variables Copy the example env and fill keys cp .env.example .env

   Edit .env to include your API keys

   WEATHER_API_KEY="YOUR_WEATHER_API_KEY" BRAVE_API_KEY="YOUR_BRAVE_API_KEY"

4. Install and run the MCP server

   Install the server entrypoint (if your setup uses mcp install)

   mcp install main.py

   Run the server locally

   mcp dev main.py

Notes:

• If you prefer a direct Python run, you can also start with: python main.py (ensure your environment is activated)
• The exact commands may vary slightly depending on your environment (virtualenv vs uv vs poetry). The README’s approach uses mcp install/dev for a smoother MCP workflow.

Environment variables: Ensure WEATHER_API_KEY and BRAVE_API_KEY are present in .env. If you encounter API key errors, double-check the keys and network access. Common issues include missing dependencies or not activating the virtual environment before running mcp commands. The server relies on external services (WeatherAPI and Brave Search), so ensure network access and valid API keys. If you migrate to a different runner, update the mcp_config accordingly. For debugging, you can run main.py directly to see Python exceptions, then apply fixes and re-run via mcp dev.