MCP Server Bootstrap

MCP Server Bootstrap: A Template for Building Modular Command Center Servers

MCP Server Bootstrap is a Python-based template for creating modular command center servers using the Mondel Context Protocol (MCP). It provides a structured foundation for building scalable command center applications with support for basic mathematical operations and modular arithmetic functions.

The project implements a modular architecture that combines individual function files into a single server core at runtime. This approach maintains code organization during development while accommodating current MCP SDK limitations regarding modularity. The template provides a foundation for building scalable command center applications with custom functionality.

Repository Structure

mcp_server/                 # Main package directory
├── build_mcp.py           # Script to combine function modules into core server file
├── functions/             # Directory containing individual function implementations
│   ├── add.py            # Addition operation implementation
│   ├── product19.py      # Modulo 19 multiplication implementation
│   └── subtract.py       # Subtraction operation implementation
├── utils/                # Utility functions and helper modules
│   └── helper.py        # Common helper functions
├── pyproject.toml       # Project metadata and dependencies
├── requirements.txt     # Project dependencies
└── setup.sh            # Installation and setup script

Usage Instructions

Prerequisites

Python 3.11 or higher
Amazon Q CLI installed and configured
pip package manager
Unix-like environment (for setup.sh)

Required packages:

fastmcp >= 1.0.0
pydantic >= 1.10.0

Installation

# Clone the repository
git clone <repository-url>
cd mcp-bootstrap

# Make the setup script executable
chmod +x setup.sh

# The setup script will configure the server for use with Amazon Q CLI
# by creating necessary configuration in $HOME/.aws/amazonq/mcp.json

# Run the setup script
./setup.sh

Quick Start

Create a new function in the mcp_server/functions directory:

# mcp_server/functions/example.py
@mcp.tool(
    name="example",
    description="Example function"
)
def example_function(a: int, b: int) -> int:
    return a + b

Build the server:

python mcp_server/build_mcp.py

Run the server:

python mcp_server/core_combined.py

Troubleshooting

Common issues and solutions:

Module Not Found Errors
- Error: ModuleNotFoundError: No module named 'fastmcp'
- Solution: Ensure you've activated the virtual environment and installed dependencies:
  source .venv/bin/activate pip install -r requirements.txt
Build Failures
- Error: FileNotFoundError: core_combined.py not found
- Solution: Run the build script from the project root:
  python mcp_server/build_mcp.py
Version Compatibility
- Error: Python version X.X is less than required 3.11
- Solution: Install Python 3.11 or higher and ensure it's in your PATH

Data Flow

The MCP server processes function calls by combining individual function modules into a single core server file, which then handles incoming requests and routes them to the appropriate function implementation.

[Client Request] -> [MCP Server Core] -> [Function Router] -> [Individual Function] -> [Response]
                                    |-> [Function Registry]

Component interactions:

The build script combines individual function files into a single core server file
The MCP server initializes with the combined functions
Client requests are received by the server core
Requests are routed to the appropriate function based on the tool name
Functions process the input and return results
The server core formats and sends the response back to the client
Error handling is managed at both the server and function levels

This server cannot be installed

security - not tested

license - not found

quality - not tested

A Python-based template for creating modular command center servers using the Mondel Context Protocol that provides a structured foundation for building scalable applications with mathematical operations and modular arithmetic functions.

Related MCP Servers

Optimized Memory MCP Server V2
AgentWong
-
security
A
license
-
quality
A Python-based server that implements the Model Context Protocol to interface with Claude Desktop as an MCP client, supporting interaction through efficient memory management.
Last updated -
1
Python
MIT License
Nash MCP Server
nash-app
-
security
A
license
-
quality
A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
Last updated -
2
Python
MIT License
MCP Server Python Template
Cris-0k
-
security
A
license
-
quality
A streamlined foundation for building Model Context Protocol servers in Python, designed to make AI-assisted development of MCP tools easier and more efficient.
Last updated -
13
Python
MIT License
MCP Calculator Server
githubpradeep
A
security
F
license
A
quality
A simple Model Context Protocol server that provides basic arithmetic operations (addition, subtraction, multiplication, division) as tools that can be called by Large Language Models.
Last updated -
4
JavaScript

View all related MCP servers

MCP Server Bootstrap