MCP Bootstrap

Bootstrap for MCP server

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "zzenonn-mcp_bootstrap": {
      "command": "python",
      "args": [
        "mcp_server/core_combined.py"
      ]
    }
  }
}

You deploy a modular MCP server that combines individual function modules into a single core at runtime, enabling scalable command center capabilities with basic math operations and modular arithmetic. This approach keeps development organized while accommodating MCP SDK constraints, and allows you to run a ready-to-use server by building and starting the core that routes to your function implementations.

How to use

You access the MCP server through an MCP client that issues tool calls by name. The server core contains a registry of functions such as add, subtract, and modulo-based operations, and it routes each request to the matching function. As you develop, you can add new functions under the functions directory and rebuild the core to expose them to clients. To run a local instance, start the combined core as your runtime server and issue tool calls to perform calculations or other supported operations.

How to install

Prerequisites are required before you begin.

Install and configure the environment and dependencies.

Concrete steps you follow to set up the server on your machine.

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

# Install project dependencies
pip install -r requirements.txt

# Clone the bootstrap template
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

# Build the MCP core from function modules
python mcp_server/build_mcp.py

# Start the MCP core that contains all functions
python mcp_server/core_combined.py

Additional sections

Data flow and runtime behavior are designed to keep the server modular and extensible. The build process combines individual function modules into a single core server file, which initializes with the merged functions and serves incoming client requests by routing them to the appropriate function implementation. If an error occurs, the server or function can handle it and return a structured response to the client.

Troubleshooting tips cover common issues you might encounter during development and runtime, including missing dependencies, build failures, and Python version compatibility. Follow the recommended commands to verify the environment, install dependencies, and rebuild or restart your server as needed.

You can extend functionality by adding new function modules inside the mcp_server/functions directory and rebuilding the core. For example, you can introduce an example function or more complex arithmetic operations by following the existing module patterns.

Available tools

add

Addition operation implemented as a tool that sums two integers and returns the result.

subtract

Subtraction operation implemented as a tool that subtracts the second integer from the first and returns the result.

product19

Modulo 19 multiplication operation implemented as a tool that multiplies two numbers with result reduced modulo 19.