简易 MCP 服务器 (Simple MCP Server)

What is Simple MCP Server?

Simple MCP Server is a sample project based on the Model Context Protocol (MCP). It implements a double-color ball number generator that produces random lottery numbers for up to 10 sets per request. The server is built with Spring Boot 3.4.4, Java 17, MCP SDK 0.9.0, and Maven.

How to use Simple MCP Server?

Clone the repository, compile with mvn clean package, and run with java -jar target/mcp-server-1.0-SNAPSHOT.jar. The service starts on port 8080 and exposes an SSE endpoint at http://localhost:8080/sse. Clients (e.g., Cursor editor) can add the server URL in their MCP configuration to invoke the double-color ball tool.

Key features of Simple MCP Server

• Generates 1–10 sets of double-color ball numbers
• Each set includes 6 red balls (1–33) and 1 blue ball (1–16)
• Serves via MCP protocol for AI assistant integration
• Built with Java 17 and Spring Boot 3.4.4

Use cases of Simple MCP Server

• Generate random double-color ball lottery numbers via a chat interface
• Demonstrate a minimal MCP server implementation for learning purposes

FAQ from Simple MCP Server

What runtime does Simple MCP Server require?

JDK 17+ and Maven 3.6+ are needed to build and run the server.

How do I configure clients like Cursor to use this server?

Add a JSON entry to your editor's MCP server settings with "url": "http://localhost:8080/sse".

Can I generate more than 10 sets of numbers?

No, the server is designed to generate 1–10 sets per request.

Where does the server run?

It runs locally on your machine at port 8080. No external network connection is needed.

What transport does the server use?

The server exposes an SSE (Server-Sent Events) endpoint at /sse.