MCP Java SDK 使用指南

1. 项目目录结构及介绍

MCP Java SDK 的目录结构如下：

modelcontextprotocol/java-sdk
├── .github                # GitHub 工作流和配置文件
├── .mvn/                  # Maven Wrapper 配置
├── mcp-bom                # 项目依赖的 BOM (Bill of Materials)
├── mcp-spring             # 集成 Spring Boot 的模块
├── mcp-test               # 测试模块
├── mcp                    # 核心模块
├── .gitattributes          # Git 属性配置
├── .gitignore             # Git 忽略文件配置
├── LICENSE                # 项目许可证
├── README.md              # 项目说明文件
├── migration-0.8.0.md     # 版本迁移指南
├── mvnw                   # Maven Wrapper 脚本
├── mvnw.cmd               # Maven Wrapper 脚本 (Windows)
├── pom.xml                # Maven 项目配置文件

• .github: 包含了项目的 GitHub Actions 工作流文件，用于自动化测试、构建等操作。
• .mvn: 包含 Maven Wrapper 的配置文件，用于确保使用正确版本的 Maven。
• mcp-bom: 包含项目依赖的物料清单，用于管理项目依赖的版本。
• mcp-spring: 提供了与 Spring Boot 集成的模块，包括客户端和服务端启动器。
• mcp-test: 包含了测试代码，用于验证 SDK 的功能。
• mcp: 核心模块，包含了 Model Context Protocol 的 Java 实现。
• .gitattributes: 定义了特定文件的 Git 属性。
• .gitignore: 指定了 Git 应该忽略的文件和目录。
• LICENSE: 包含了项目的许可证信息。
• README.md: 项目的基本介绍和使用说明。
• migration-0.8.0.md: 提供了从旧版本迁移到 0.8.0 版本的指南。
• mvnw 和 mvnw.cmd: Maven Wrapper 脚本，用于简化 Maven 的安装和使用。
• pom.xml: Maven 项目的主配置文件，定义了项目的依赖、构建配置等信息。

2. 项目的启动文件介绍

项目的启动文件主要位于 mcp-spring 模块中。该模块提供了 Spring Boot 的启动器，使得用户可以快速创建一个支持 Model Context Protocol 的 Spring Boot 应用。

启动文件通常为：

mcp-spring/src/main/java/com/modelcontextprotocol/spring/autoconfigure/McpAutoConfiguration.java

这个类是自动配置类，它负责配置和初始化 Model Context Protocol 所需的 Spring Beans。

在 mcp-spring 模块下，还有以下重要的启动类：

mcp-spring/src/main/java/com/modelcontextprotocol/spring/boot/McpSpringBootApplication.java

这个类是 Spring Boot 的应用启动类，它使用了 @SpringBootApplication 注解，是应用的入口点。

3. 项目的配置文件介绍

项目的配置文件通常位于项目的 src/main/resources 目录下。以下是主要的配置文件：

• application.properties 或 application.yml: Spring Boot 应用的标准配置文件，用于定义应用的各种属性和配置。
• logback-spring.xml: Logback 日志框架的配置文件，用于配置日志的输出格式和级别。

例如，application.properties 文件可能包含如下配置：

# Model Context Protocol 配置
mcp.host=127.0.0.1
mcp.port=8080

这些配置指定了 Model Context Protocol 服务端的地址和端口。开发者可以根据实际需求调整这些配置。

在开发过程中，还可以创建额外的配置文件，如 application-dev.properties 用于开发环境，application-test.properties 用于测试环境，以适应不同环境下的配置需求。