mcp-server-modular

InCoB/mcp-server-modular

3.2

If you are the rightful owner of mcp-server-modular 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.

The MCP Demo Server is a modular server designed to demonstrate best practices for building Model Context Protocol (MCP) applications.

MCP Demo Server

Running

masteraccount@Mac Server % cd mcp-server-demo masteraccount@Mac mcp-server-demo % export PYTHONPATH=$PWD/src uv run mcp dev src/mcp_demo/server.py

A modular Model Context Protocol (MCP) server that demonstrates best practices for building MCP applications.

Project Structure

mcp-demo/
ā”œā”€ā”€ src/
ā”‚   ā””ā”€ā”€ mcp_demo/           # Main package
ā”‚       ā”œā”€ā”€ config/        # Configuration settings
ā”‚       ā”œā”€ā”€ resources/     # MCP resources
ā”‚       ā”œā”€ā”€ tools/        # MCP tools by domain
ā”‚       ā”œā”€ā”€ utils/        # Shared utilities
ā”‚       ā”œā”€ā”€ __init__.py   # Package initialization
ā”‚       ā””ā”€ā”€ server.py     # Main server entry point
ā”œā”€ā”€ pyproject.toml        # Project configuration and dependencies
ā””ā”€ā”€ README.md            # This file

Prerequisites

  • Python 3.11 or higher
  • uv package manager

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/mcp-demo.git
cd mcp-demo

  2. Install the package and dependencies:

    uv pip install .

Running the Server

You can run the server using uv:

uv run src/mcp_demo/server.py

Development

To install in development mode:

uv pip install -e .

Features

  • Modular architecture with clear separation of concerns
  • Type-safe implementation
  • Comprehensive error handling
  • Security-first approach
  • Easy to extend with new tools and resources

Documentation

For detailed documentation on:

License

MIT