Spring MCP Server

Spring MCP Server

基于 Spring AI v1.0.0 开发

• https://docs.spring.io/spring-ai/reference/1.0/index.html
  • https://github.com/spring-projects/spring-ai/tree/v1.0.0
  • https://github.com/modelcontextprotocol/servers

仓库

• mcp-server
  • 使用 Spring AI 构建的 MCP 服务
• chat-server
  • 使用 Spring AI 构建的聊天服务
• mcp-tool
  • 用于发起 MCP 工具请求的工具，可帮助理解该协议

设置

Ubuntu 设置

如果你在 Ubuntu 环境下工作，请安装所需的软件包：

sudo apt-get update
sudo apt-get install -y openjdk-21-jdk gradle locales
sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8 LC_ALL=en_US.UTF-8

确保将 Java 21 配置为默认 JDK，并直接在项目目录中运行 gradle 命令。

常用 Gradle 命令

gradle test
gradle :mcp-app:bootJar
gradle :mcp-server:runMcpTestSse
gradle :mcp-server:runMcpTestStdio
gradle spotlessCheck  # verify formatting
gradle spotlessApply  # automatically format sources

配置

mcp-server 模块会读取 tool-context.home 属性，以填充 ToolContextService 返回的环境信息。默认的 application.yml 会将此属性映射到 TOOL_CONTEXT_HOME 环境变量，并在该变量未设置时回退到 HOME：

tool-context:
  home: ${TOOL_CONTEXT_HOME:${HOME}}

你可以通过 Spring 配置覆盖此值，或在运行服务时导出 TOOL_CONTEXT_HOME 变量。

许可证

本项目采用 MIT 许可证 授权。