Modular MCP Server & Client

# 🌤️ 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`](https://github.com/astral-sh/uv) package manager (used to run client/server scripts) - MCP-compatible client and server setup ### Add Environment Variables ```bash touch .env echo "ANTHROPIC_API_KEY=<your key here>" >> .env echo ".env" >> .gitignore ``` --- ### 🖥️ Run the Server To start the tool server: ```bash uv run server/main.py ``` ### 🧑‍💻 Run the Client To start the client server: ```bash 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: ```yaml # config.yaml tools: - tools.weather_tools - tools.search_tools # Your new tools ```