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.