Build-Custom-MCP-Servers

🚀 Build Custom MCP Servers 📝☀️📰

📖 Project Description

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

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

It utilizes API keys stored in a .env file for external services.

🛠️ Setup Instructions

Follow these steps to get the FastMCP agent running:

1. Prerequisites:

   • Python 3.12 installed.
   • A virtual environment manager (like venv, pipenv, poetry, or uv) is recommended.

2. Clone the Repository (if you haven't already):

   # Make sure 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 Virtual Environment & Install Dependencies:

   • Install dependencies (assuming uv, based on uv.lock, otherwise adjust for pip/poetry):

     uv sync
     uv lock
     source .venv/bin/activate  # On Windows use `.venv\Scripts\activate`
     

   • OR

     pip install uv # if you don't have uv
     uv pip install -r requirements.txt # Or uv sync if using pyproject.toml directly
     # If not using uv, likely: 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 Agent:

   • 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-taking capabilities (add, read, latest, summarize) 📝
• Current weather fetching ☀️
• Brave Search integration for news 📰
• Configuration via .env file 🔑
• Built with mcp[cli] ⚙️

🤝 Contributing

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