mcp_server_generator

Introduction

mcp_server_generator is an open-source library designed to automatically generate a full MCP server codebase in Node.js, Python, or Java using a validated schema. The generated server includes modular files that are ready for CLI-based execution or integration with Claude Desktop. This tool ensures that developers can focus on their application logic while the generator handles the boilerplate code and best practices.

Features

• Multi-Language Support: Supports TypeScript (Node.js), Python, and Java output.
• Tool Creation: Generates essential tools, resources, prompts, and transports necessary for your server.
• Modular Codebase: Outputs a structured, modular codebase that is easy to navigate and extend.
• Ready-to-Run Server: Provides a fully functional server setup with minimal configuration required.
• Claude Desktop Compatibility: Ensures the generated structure is compatible with Claude Desktop integration.
• SDK-Compliant Directory Structure: Follows SDK-compliant best practices for directory organization.

Installation Instructions

Node.js (TypeScript)

To install mcp_server_generator in a TypeScript project, use npm:

npm install mcp_server_generator --save-dev

Python

For Python projects, you can install the library using pip:

pip install mcp-server-generator

Java

In your Java project, add the following dependency to your pom.xml if you are using Maven:

<dependency>
    <groupId>com.github.yourusername</groupId>
    <artifactId>mcp_server_generator</artifactId>
    <version>1.0.0</version>
</dependency>

Ensure you have the correct repository configured in your pom.xml if it's hosted on a custom Maven server.

Usage Examples

Node.js (TypeScript)

import { generateServer } from 'mcp_server_generator';

const schema = {
    // Your validated schema here
};

generateServer(schema, 'node', './output')
    .then(() => console.log('Server generated successfully!'))
    .catch(err => console.error('Error generating server:', err));

Python

from mcp_server_generator import generate_server

schema = {
    # Your validated schema here
}

generate_server(schema, 'python', './output')
print("Server generated successfully!")

Java

import com.github.yourusername.mcp_server_generator.McpServerGenerator;

public class Main {
    public static void main(String[] args) {
        try {
            Map<String, Object> schema = new HashMap<>();
            // Populate your validated schema here
            
            McpServerGenerator.generateServer(schema, "java", "./output");
            System.out.println("Server generated successfully!");
        } catch (Exception e) {
            System.err.println("Error generating server: " + e.getMessage());
        }
    }
}

API Documentation

generateServer Function

Node.js/TypeScript

generateServer(schema: object, language: 'node' | 'python' | 'java', outputDir: string): Promise<void>

• schema: The validated schema to be used for generating the server.
• language: The target programming language (node, python, or java).
• outputDir: The directory where the generated files will be placed.

Python

generate_server(schema: dict, language: str, output_dir: str) -> None

• schema: A dictionary representing the validated schema.
• language: The target programming language (node, python, or java).
• output_dir: A string specifying the directory for generated files.

Java

public static void generateServer(Map<String, Object> schema, String language, String outputDir) throws Exception

• schema: A map containing the validated schema.
• language: The target programming language (node, python, or java).
• outputDir: The directory where the generated files will be placed.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Feel free to contribute to this library and make it better!

⚠️ Development Status

This library is currently in early development. Some tests may be failing with the following issues:

Contributions to fix these issues are welcome! Please submit a pull request if you have a solution.