What is Build Custom Mcp Servers

Build-Custom-MCP-Servers is a project that showcases a simple MCP server built using the MCP mcp[cli] Python SDK. It provides tools for note management, weather information retrieval, and news searching.

Use cases

Use cases include managing personal notes, checking weather updates for specific locations, and searching for the latest news articles.

How to use

To use Build-Custom-MCP-Servers, clone the repository, set up a virtual environment, install dependencies, configure environment variables with your API keys, and run the agent.

Key features

Key features include note management (adding, reading, retrieving, and summarizing notes), fetching current weather data for specified cities, and performing news searches using the Brave Search API.

Where to use

Build-Custom-MCP-Servers can be used in various fields such as personal productivity, weather tracking, and news aggregation.

🚀 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.