Build Custom MCP Servers

🚀 Guide to Building a Custom MCP Server

This project demonstrates a simple MCP server built using the MCP mcp[cli] Python SDK. It offers several tools exposed through the MCP server:

• Note Management: Add, read, retrieve the latest notes, and generate note summaries. All notes are stored locally.
• Weather Information: Fetch the current weather data for a specified city using the WeatherAPI.com service.
• News Search: Perform news searches using the Brave Search API.

This project utilizes API keys stored in the .env file to call external services.

🚀 Quick Start

📦 Installation

Follow these steps to run the FastMCP proxy:

1. Prerequisites:

   • Python 3.12 is installed.
   • It is recommended to use a virtual environment management tool (e.g., venv, pipenv, poetry, or uv).

2. Clone the repository (if not already cloned):

   # Ensure you are in the correct parent directory
   git clone https://github.com/sourangshupal/Build-Custom-MCP-Servers # Or use the current directory if already cloned
   cd Build-Custom-MCP-Servers 
   

3. Set up the virtual environment and install dependencies:

   • Install dependencies (assuming uv is used, based on the uv.lock file; otherwise, adjust to pip/poetry):

     uv sync
     uv lock
     source .venv/bin/activate  # Use `.venv\Scripts\activate` on Windows
     

   • Or

     pip install uv # If you haven't installed uv
     uv pip install -r requirements.txt # Or uv sync if using pyproject.toml directly
     # If not using uv, typically: pip install -r requirements.txt or poetry install or pip install .
     

4. Configure environment variables:

   • Copy the example environment file:

     cp .env.example .env
     

   • Edit the newly created .env file and add your API keys:

     WEATHER_API_KEY="YOUR_WEATHER_API_KEY"
     BRAVE_API_KEY="YOUR_BRAVE_API_KEY"
     

5. Run the proxy:

   • Execute the main script:

     mcp install main.py
     

   • The FastMCP server should be added to Claude Desktop.

     mcp dev main.py
     

   • Debug the MCP server

✨ Features

• Note Management: Add, read, view the latest, and generate summaries 📝
• Weather Forecast: Get the current weather for a specified city ☀️
• Brave Search Integration: For news searches 📰
• Configuration via .env File: Enables key management 🔑
• Built with mcp[cli] ⚙️

🤝 Contribution Guidelines

Contributions are welcome! Feel free to submit pull requests or open issues.