simple-mcp-server

simple-mcp-server

0
entertainment_and_media

This project is a demonstration of a simple MCP server that generates random Double Color Ball lottery numbers. It utilizes Spring Boot and Java, providing services over the MCP protocol for compatible clients.

简易 MCP 服务器 (Simple MCP Server)

| 中文

项目介绍

这是一个基于 Model Context Protocol (MCP) 的简单示例项目。项目实现了一个双色球号码生成工具，可以随机生成指定数量的双色球号码。

技术栈

  • Spring Boot 3.4.4
  • Java 17
  • MCP SDK 0.9.0
  • Lombok
  • Maven

功能特性

  • 支持生成1-10组双色球号码
  • 每组号码包含6个红球(1-33)和1个蓝球(1-16)
  • 通过MCP协议提供服务，可以与支持MCP的客户端（如大语言模型）进行交互

项目运行

本地运行

  1. 确保你已安装以下环境：

    • JDK 17+
    • Maven 3.6+

  2. 克隆项目：

git clone https://github.com/beilingai/simple-mcp-server.git
cd simple-mcp-server
  1. 编译项目：
mvn clean package
  1. 运行项目：
java -jar target/mcp-server-1.0-SNAPSHOT.jar
  1. 服务将在默认端口8080启动

如何使用

本服务通过MCP协议提供工具，可以被支持MCP的客户端调用。

调用示例：

Cursor中调用示例

在Cursor编辑器中，可以通过以下方式调用本服务：

  1. 在设置中添加本地MCP服务器地址
{
   "mcpServers": {
      "double-color-ball-mcp-server": {
         "url": "http://localhost:8080/sse"
      }
   }
}
  1. 在聊天窗口中请求生成双色球号码： 
    请帮我生成3组双色球号码
  2. AI助手会调用本MCP服务并返回生成的结果，例如： 
    生成的双色球号码如下：

第1组: 05 11 16 22 30 33 + 08
第2组: 03 06 14 20 25 31 + 12
第3组: 02 09 17 25 29 32 + 06