Build-Custom-MCP-Servers
If you are the rightful owner of Build-Custom-MCP-Servers and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project demonstrates a simple MCP Server built using the MCP `mcp[cli]` Python SDK, providing tools for note management, weather information, and news search.
๐ 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:
-
Prerequisites:
- Python 3.12 installed.
- A virtual environment manager (like
venv,pipenv,poetry, oruv) is recommended.
-
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 -
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 .
- Install dependencies (assuming uv, based on uv.lock, otherwise adjust for pip/poetry):
-
Configure Environment Variables:
- Copy the example environment file:
cp .env.example .env - Edit the newly created
.envfile and add your API keys:WEATHER_API_KEY="YOUR_WEATHER_API_KEY" BRAVE_API_KEY="YOUR_BRAVE_API_KEY"
- Copy the example environment file:
-
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
.envfile ๐ - Built with
mcp[cli]โ๏ธ
๐ค Contributing
Contributions are welcome! Please feel free to submit pull requests or open issues.
