Spring AI MCP Games Demo

春季AI MCP游戏演示

一个Spring Boot应用程序，将游戏奖励信息作为MCP服务器公开。该项目演示了如何使用Spring AI创建MCP服务器，该服务器可以与AI助手和n8n等工作流自动化工具集成。

特性

• MCP服务器：通过MCP协议公开游戏奖励工具
• 游戏奖励API：提供棋盘游戏的详细奖励信息
• Spring Boot集成：内置Spring Boot 3.5.7和Spring AI 1.0.2

先决条件

• Java 25 或更高
• Maven 3.6+ 或使用附带的Maven Wrapper(./mvnw)
• 龙目：生成所需的注释处理器

入门指南

建设项目

# Using Maven Wrapper (recommended)
./mvnw clean package

# Or using system Maven
mvn clean package

运行应用程序

# Using Maven Wrapper
./mvnw spring-boot:run

# Or run the JAR directly
java -jar target/games-0.0.1-SNAPSHOT.jar

应用程序将于启动 http://localhost:8080

可用工具

获取游戏奖励

返回棋盘游戏的奖励详细信息和团队所有权信息。

参数:

• gameName （String）：游戏名称

- 有效选项： Monopoly, Chess, Scrabble

示例:

// Monopoly
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "getGameRewards",
    "arguments": {
      "gameName": "Monopoly"
    }
  }
}

与n8n集成

此MCP服务器可以与n8n工作流自动化集成。该项目包括一个即用型n8n工作流。

n8n工作流文件

该项目包括一个完整的n8n工作流，该工作流将MCP服务器与会话式AI代理集成在一起：

n8n/games.json -完整的工作流程，包括：

• MCP客户端工具：连接到 http://host.docker.internal:8080/sse 致电 getGameRewards 工具
• OpenAI代理：GPT驱动的会话代理，带聊天内存
• 聊天界面：用于交互式查询的基于Webhook的聊天触发器
• RAG系统：带有嵌入的矢量存储，用于检索游戏功能信息
• 数据导入：从数据文件自动导入游戏功能

n8n/games.txt -游戏功能目录包含：

• 关于扑克、二十一点、轮盘赌、老虎机和宾果游戏的信息
• 奖励分配百分比（筹码、硬币、宝石、经验值）
• 每场比赛的团队所有权
• 详细的游戏描述

该工作流程允许用户与AI助手聊天，该助手可以：

• 通过MCP服务器查询实时游戏奖励（大富翁、国际象棋、拼字游戏）
• 从RAG系统检索历史游戏功能（扑克、二十一点等）
• 保持对话背景和记忆

导入n8n工作流

1. 启动Spring Boot应用程序：

   ./mvnw spring-boot:run

1. 在n8n中导入工作流：

- 打开n8n用户界面 - 首选 工作流 → 从文件导入 - 选择 n8n/games.json - 如果需要，更新MCP端点URL（默认值： http://host.docker.internal:8080/sse)

1. 配置凭据：

- 添加您的OpenAI API证书 - 确保MCP服务器可以从n8n的Docker网络访问

1. 激活并使用工作流：

- 工作流程提供了一个聊天界面来查询游戏信息 - 它使用MCP服务器获取实时数据，使用RAG获取历史游戏功能

快速集成步骤

如果手动设置：

1. 在主机上启动应用程序
2. 配置n8n HTTP请求节点以使用： http://host.docker.internal:8080/sse
3. 初始化SSE连接以获取会话ID
4. 向发送MCP协议消息 /mcp/message?sessionId={sessionId}

项目结构

.
├── n8n/                                       # n8n workflow files
│   ├── games.json                             # n8n workflow definition
│   └── games.txt                              # Game features data for RAG
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/clubulprogramatorilor/tools/games/
│   │   │       ├── GamesApplication.java          # Main application class
│   │   │       ├── mcp/
│   │   │       │   └── McpToolConfiguration.java  # MCP tool configuration
│   │   │       └── tools/
│   │   │           └── ToolsConfiguration.java    # Game reward tool implementation
│   │   └── resources/
│   │       └── application.properties              # Application configuration
│   └── test/
│       └── java/
│           └── com/clubulprogramatorilor/tools/games/
│               └── GamesApplicationTests.java      # Application tests
├── pom.xml                                    # Maven dependencies
└── README.md                                  # This file

依赖项

• Spring Boot 3.5.7
• 春季AI 1.0.2（MCP服务器WebVC入门版）
• 龙目 1.18.42
• Maven编译器插件 （为Java 25配置）