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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A modular and extensible tool server built on FastMCP that supports multiple tools organized across files and communicates via MCP protocol.

Related MCP Servers

Toolhouse MCP Server
toolhouse-community
-
security
A
license
-
quality
This MCP server allows you to connect MCP clients with Toolhouse's tools.
Last updated -
13
Python
MIT License
Math Expression MCP Server
eriktilio
-
security
A
license
-
quality
A tool server that processes mathematical expressions via Multi-Chain Protocol (MCP), allowing LLMs to solve math problems through tool integration.
Last updated -
Python
MIT License
Routine
mquan
-
security
F
license
-
quality
An MCP server that allows users to create custom tools on the fly by stitching together actions from multiple MCP tools into reusable routines.
Last updated -
21
1
TypeScript
MCP Code Editor
alejoair
-
security
A
license
-
quality
A FastMCP server providing powerful code editing tools including precise file modifications with diff-based operations, file creation and reading with line numbers, and more tools for code editing workflows.
Last updated -
Python
MIT License

View all related MCP servers

Modular MCP Server & Client