🌤️ 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

🚀 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