🚀 模型上下文协议（MCP）服务器示例实现 - 使用Spring Boot

本项目是一个基于Spring Boot实现的模型上下文协议（MCP）服务器示例。该服务器可与MCP检查程序配合使用，用于测试和调试。它提供了简单的REST API与服务器交互，同时展示了如何搭建基础的Spring Boot应用程序，还包含单元测试以验证服务器功能。

🚀 快速开始

若要使用此MCP服务器，请按以下步骤操作：

1. 克隆仓库

git clone https://github.com/your-repository.git
cd mcp-server

2. 构建项目 运行以下命令构建项目：

mvn clean install

3. 运行服务器 构建完成后，运行以下命令启动服务器：

java -jar target/mcp-server-0.0.1-SNAPSHOT.jar

4. 测试API 使用curl或其他工具测试REST API。例如：

curl http://localhost:8080/api/test

✨ 主要特性

• 基于Spring Boot实现，为MCP服务器提供了简单的REST API进行交互。
• 可与MCP检查程序配合使用，方便进行测试和调试。
• 包含单元测试，能有效验证服务器功能。
• 借助MCP开放标准，让AI模型可通过一致协议与各种工具交互。

📦 安装指南

要求

• Java 17+版本
• Maven
• MCP检查程序（可选，用于测试）

例如Claude桌面的配置

{
  "mcpServers": {
    "sample-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "sample-mcp-server-0.0.1-SNAPSHOT.jar",
        "--port",
        "8080",
        "--host",
        "localhost"
      ],
      "env": {
        "JAVA_TOOL_OPTIONS": "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005"
      }
    }
  }
}

⚠️ 重要提示

JAVA_TOOL_OPTIONS环境变量用于设置JVM选项以进行远程调试。地址和端口可根据需要更改。

💻 使用示例

基础用法

以下是使用curl测试REST API的示例：

curl http://localhost:8080/api/test

📚 详细文档

🧠 什么是MCP？

模型上下文协议（MCP）是一个开放标准，定义了AI模型如何与外部工具和数据源通信。它为AI助手如Claude提供了访问以下内容的标准方式：

• 🌐 实时信息
• 📊 自定义数据库
• 🔄 API和服务
• 📁 文件系统

想象一下MCP就像“AI的USB标准”——它提供了一个通用接口，允许任何AI模型通过一致协议与各种工具交互。

使用Spring Boot的好处：

• 🔄 无缝集成：轻松将应用程序的功能暴露给AI助手
• 🛠️ 工具定义：使用简单注解定义自定义工具
• 🚀 Spring Boot简便性：利用Spring的依赖注入和配置管理
• 📈 增强的AI功能：让AI模型访问组织的实时数据和服务

开发

调试

安装MCP检查程序

npm -g install @modelcontextprotocol/inspector

运行MCP检查程序进行测试

• 构建MCP服务器

mvn clean package

• 运行MCP检查程序

npx @modelcontextprotocol/inspector -- sample-mcp-server.json

🔧 技术细节

模型上下文协议（MCP）作为开放标准，为AI模型与外部工具和数据源的通信提供了规范。本项目基于Spring Boot实现MCP服务器，借助Spring的依赖注入和配置管理等特性，实现了服务器与MCP检查程序的配合使用。通过简单的REST API，方便与服务器进行交互，同时利用单元测试保证服务器功能的正确性。

📄 参考资料

Spring AI 延伸了 MCP Java SDK 的功能