AI导哈

MCP服务器框架

基于Spring Boot的MCP（Model Context Protocol）服务器构建框架，包含可重用库和参考客户端应用。

  • by clsanc195
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 clsanc195/springboot-plugable-mcp

使用说明

弹簧靴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

相关 MCP