弹簧靴MCP
使用Spring Boot构建MCP（模型上下文协议）服务器的框架。由可重用库和参考客户端应用程序组成。
项目
| 项目 | 描述 |
|---|---|
| SpringPluggableMcp | 将任何Spring Boot应用程序转换为具有可插拔工具加载和执行的MCP服务器的库 |
| McpHostApp | 演示静态工具、动态工具源和执行策略的参考客户端 |
快速开始
docker compose up -d --build这将开始：
| 服务 | 端口 | 描述 |
|---|---|---|
mcp-tools-db | 5432 | 带有种子数据的PostgreSQL 17 |
mcp-server | 8080 | MCP服务器（McpHostApp） |
mcp-inspector | 6274 | MCP检查器用户界面 |
端点
| URL | 描述 |
|---|---|
http://localhost:8080/mcp | MCP可流式HTTP端点 |
http://localhost:8080/actuator/mcptools | 工具仪表板（所有注册的工具+源健康状况） |
http://localhost:8080/health | 健康检查 |
http://localhost:6274 | MCP检查器（通过流式HTTP连接到 http://mcp-server:8080/mcp) |
数据库
Host: localhost:5432
Database: mcp_tools
User: postgres
Password: postgres先决条件
- Docker和Docker Compose
- Java 21+和Maven 3.9+（用于本地开发）
本地开发
# Build the library and install to local Maven repo
cd SpringPluggableMcp && mvn install -DskipTests
# Build and run the host app
cd ../McpHostApp && mvn spring-boot:run需要一个正在运行的PostgreSQL实例--use docker compose up -d postgres 只启动数据库。
项目结构
.
├── docker-compose.yml # Orchestrates all services
├── Dockerfile # Multi-stage build (library + host app)
├── db/
│ └── init.sql # Database schema and seed data
├── inspector-entrypoint.sh # MCP Inspector startup patch
├── SpringPluggableMcp/ # Library
└── McpHostApp/ # Client