MCP Server Factory

🚀 MCP Server Factory

A Java-based Model Context Protocol (MCP) server designed to aid in understanding and building other MCP servers.

🚀 Quick Start

This project serves as both a learning tool and a guide for building MCP servers. It focuses on providing the following:

1. Understanding of MCP components:

   • Tools (action functions that perform specific functions)
   • Resources (data sources that provide information)
   • Prompts (structured templates for generating responses)

2. Templates and best practices for building MCP servers

✨ Features

1. Tool section:

   • explain_concept - Provides detailed explanations of MCP concepts (tools, resources, prompts, servers, clients)
   • Task planning tools:
     • code_cleanup_planner - Generates a task plan for code cleanup goals
     • feature_implementation_planner - Generates a task plan for feature implementation goals
     • general_task_planner - Generates a task plan for general goals
     • local_mcp_deployment_planner - Generates a task plan for deploying a local MCP server, including key cleanup and testing steps, and terminates the deployment on failure

2. Resource section:

   • mcp://factory/documentation/{topic} - Documentation on MCP topics (getting started guides, best practices, troubleshooting)

3. Prompt section:

   • tool_implementation_guide - Step-by-step guides in different languages for implementing MCP tools

🔧 Technical Details

Architecture

The MCP Server Factory is built using the following technologies:

• Java, based on the Spring framework (not Spring Boot)
• log4j2 for logging implementation
• Maven for build management

It follows these design principles:

• KISS (Keep It Simple, Stupid)
• DRY (Don't Repeat Yourself)
• YAGNI (You Aren't Gonna Need It)
• SOLID (Single Responsibility, Open-Closed, Liskov Substitution, Interface Segregation, Dependency Inversion)

Project Structure

• src/main/java/user/jakecarr/ - Main source code

  • .../config/ - Spring configuration
  • .../main/ - Classes containing the main method
  • .../model/ - Domain models and interfaces
  • .../model/impl/ - MCP component implementations
  • .../service/ - Business logic and services

• docs/api/ - API documentation

  • prompts.md - Documentation for supported prompts
  • resources.md - Documentation for supported resources
  • tools.md - Documentation for supported tools

Code Quality

The codebase adheres to high standards:

• Well-structured code with clear separation of concerns
• Comprehensive documentation with Javadoc comments for all classes and methods
• Modular design using abstract base classes and interfaces
• Consistent error handling with appropriate logging
• Maintainable architecture with extracted methods and helper functions
• Clean code practices including:
  • Descriptive naming conventions
  • Single Responsibility Principle
  • DRY (Don't Repeat Yourself) Principle
  • Proper encapsulation

📦 Installation

Prerequisites

• Java 21 or higher
• Maven 3.6 or higher
• MCP Java SDK 0.8.1 (located at C:/Users/jayes/vscode/java-sdk-0.8.1/java-sdk-0.8.1)

Build

Run the following command to build the project:

mvn clean package

Run

To run the MCP server, execute the following command:

mvn spring-boot:run

📚 Documentation

Developers

• Author: Jake C.
• Email: jakec@example.com
• Contributors: [List of contributors]

📄 License

[License information for the project should be included here, such as Apache 2.0 or MIT license.]

Acknowledgments

Thanks to all who have contributed to this project!