MCP Tool Generator

MCP (Model Context Protocol) Tool Generator is an automated server generator for MCP projects. It uses OpenAPI 3.x-compliant Swagger files to create MCP servers efficiently, streamlining the integration and deployment process with minimal changes.

Installation

Clone the repository:

git clone https://github01.hclpnp.com/SPARC-Development-Lab/mcp_scaffolder.git
cd mcp_scaffolder

Project Structure

MCP/
├── mcp_tool_generator/
│   ├── __init__.py
│   ├── client_utils.py
│   ├── file_handling_generator.py
│   ├── jwt_authentication.py
│   ├── model_utils.py
│   ├── openapi_utils.py
│   ├── output_utils.py
│   ├── server_init.py
│   └── wrapper_utils.py
├── .env
├── main.py
├── swagger.json or swagger.yaml
└── included_endpoints.json

File Description

• __init__.py — Package initializer.
• client_utils.py — Utilities for client-side operations and interactions.
• file_handling_generator.py — Generates file attachment handler code with validation and encoding support.
• jwt_authentication.py — Generates JWT token verifier code with AWS Secrets Manager integration.
• model_utils.py — Functions for model management and manipulation.
• openapi_utils.py — Helpers for working with OpenAPI specifications and related tasks.
• output_utils.py — Output formatting and processing utilities.
• server_init.py — Server initialization logic and configuration.
• wrapper_utils.py — General-purpose wrapper functions for various utilities.
• .env — Environment variable definitions for configuration.
• main.py — Entry point script for running the MCP Tool Generator.
• swagger.json/swagger.yaml — OpenAPI specification files describing API endpoints.
• included_endpoints.json — List of API endpoints to include in server generation.

Download Dependencies

Before running the MCP Tool Generator, ensure that Python 3.11.9 is installed on your system. Install all required dependencies as specified in the requirements.txt file.

Use the following command in the shell to install them:

pip install -r requirements.txt

Usage

OPENAPI Compliance Check

Check the compliance of an OpenAPI Swagger file against the OpenAPI 3.0 specification before generating the MCP server. It is recommended to use the 'spectral' package for linting and validating the OpenAPI document to ensure it adheres to the required standards.This helps prevent issues during server generation and ensures best practices are followed.

Environment Setup

Configure the .env file with your LLM (Large Language Model) credentials and any other required environment variables before running the MCP Tool Generator.

Tool Execution

To run the MCP Tool Generator, execute the main.py script with the appropriate command-line arguments as shown below:

python main.py -p <path_to_swagger_file> -o <mcp_server_output_file_name.py> -im <get,put> -od <output_directory_path>

To generate an MCP server for only the endpoints specified in included_endpoints.json, use the following command:

python main.py -p <path_to_swagger_file> -o <mcp_server_output_file_name.py> -iep <included_endpoints_json_file_name.json> -od <output_directory_path>

After Running the Tool

Generated Output Structure

Once the MCP Tool Generator completes execution, your project directory will include the following structure:

MCP/
├── mcp_tool_generator/
├── MCPServer_dir/
│   ├── client/           # Auto generated Client-related files
│   ├── mcpserver.py      # Generated MCP server script
│   ├── ssl.cert          # SSL certificate to be added by user
│   └── ssl.key           # SSL key to be added by user
|
├── .env
├── main.py
├── swagger.json or swagger.yaml
└── included_endpoints.json

SSL certificate generation

Refer - OpenSSL