🌤️ Modular MCP Server & Client

This project provides a modular and extensible tool server built on FastMCP. It supports multiple tools organized across files and is compatible with a local or remote client that communicates via the MCP protocol.

📁 Project Structure

├── server.py # Defines and exports the shared FastMCP instance ├── main.py # Entry point to run the server ├── tools/ │ └── weather_tools.py # Weather-related tools (alerts, forecast) ├── client/ │ └── main.py # Entry point to run the client └── config.yaml # Configuration file for the server

Related MCP server: Math Expression MCP Server

🚀 Getting Started

🔧 Requirements

Python 3.10+
uv package manager (used to run client/server scripts)
MCP-compatible client and server setup

Add Environment Variables

touch .env echo "ANTHROPIC_API_KEY=<your key here>" >> .env echo ".env" >> .gitignore

🖥️ Run the Server

To start the tool server:

uv run server/main.py

🧑‍💻 Run the Client

To start the client server:

uv run client/main.py <Path to server>

Replace <Path to server> with the local or remote path to the server script (e.g. server/main.py).

🧩 Extending the Server

You can easily extend this server with additional tools. 1. Create a new module in the tools/ directory (e.g., tools/finance_tools.py). 2. Define your functions using the @mcp.tool() decorator. 3. In config.yaml, add your new module to the tools list to register the tools.

Example:

# config.yaml tools: - tools.weather_tools - tools.search_tools # Your new tools