MCP Server Factory

What is MCP Server Factory?

MCP Server Factory is a Java-based Model Context Protocol (MCP) server that serves as a learning tool and guide for building other MCP servers. It provides an understanding of MCP components—tools, resources, and prompts—along with templates and best practices.

How to use MCP Server Factory?

Clone the repository, then build with mvn clean package (requires Java 21+, Maven 3.6+, and the MCP Java SDK 0.8.1). Run the server with java -jar target/mcp-server-factory-1.0-SNAPSHOT-jar-with-dependencies.jar. Use an MCP client to invoke its provided tools, resources, and prompts.

Key features of MCP Server Factory

• Includes tools like explain_concept and task planners (code cleanup, feature implementation, general, local MCP deployment)
• Resources available at mcp://factory/documentation/{topic} covering MCP topics
• Prompts such as tool_implementation_guide for multi-language tool implementation
• Built with Java, Spring Framework (not Spring Boot), log4j2, and Maven
• Follows KISS, DRY, YAGNI, and SOLID design principles
• Well-structured code with Javadoc, modular design, and clean code practices

Use cases of MCP Server Factory

• Learn about MCP concepts and how to build your own MCP servers
• Get step-by-step guidance for implementing MCP tools in different languages
• Plan code cleanup, feature implementation, or local MCP deployment tasks
• Access structured documentation on MCP getting started, best practices, and troubleshooting

FAQ from MCP Server Factory

What are the prerequisites to run MCP Server Factory?

Java 21 or higher, Maven 3.6 or higher, and the MCP Java SDK 0.8.1 are required.

How do I build and run the server?

Clone the repository, run mvn clean package, then execute java -jar target/mcp-server-factory-1.0-SNAPSHOT-jar-with-dependencies.jar.

What MCP components does the server provide?

It provides tools (e.g., explain_concept, task planners), resources (documentation on MCP topics), and prompts (e.g., tool_implementation_guide).

What license is the project under?

MCP Server Factory is licensed under the MIT License.

What development guidelines are enforced in the codebase?

Core business logic must not depend on Spring, Spring annotations are allowed only in the config package, no mocks in src/main/java, no recursion, and tests must include timeouts.