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