AI导哈

AI助手协议服务器

一个基于Spring Boot的模型上下文协议（MCP）服务器实现，支持与Claude等AI客户端的无缝集成。

  • by cwtwcz
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 cwtwcz/mcp-ai-assistant

使用说明

人工智能助手-MCP服务器

基于Spring Boot的模型上下文协议（MCP）服务器实现，可与Claude和其他AI客户端无缝集成。

什么是MCP？

模型上下文协议（MCP）是一个开放标准，使AI助手能够安全地与本地和远程资源进行交互。该项目使用Spring AI实现了一个MCP服务器，允许Claude和其他AI客户端通过标准化的接口访问工具、提示和数据。

概述

此MCP服务器使用Spring Boot 3.5.7和Spring AI 1.1.0构建，为AI驱动的工作流提供了一个可扩展的平台。它公开了由H2数据库支持的MCP兼容端点，用于持久状态管理。

特性

  • MCP服务器实现：通过Spring AI提供完整的模型上下文协议服务器支持
  • 永久存储：带JPA的H2数据库，用于数据持久化
  • 热重新加载：具有自动重新加载功能的开发模式
  • 可扩展架构：模块化封装结构，便于添加功能

先决条件

  • Java 21或更高版本
  • Maven 3.8+（或使用附带的包装器）
  • Git

快速开始

安装

# Clone the repository
git clone <repository-url>
cd mcp-ai-assistant

# Run the application
./mvnw spring-boot:run

MCP服务器将在配置的端口（默认：8080）上启动。

建筑

# Build the project
./mvnw clean package

# Run the built JAR
java -jar target/ai-assistant-0.0.1-SNAPSHOT.jar

配置

配置通过以下方式管理 src/main/resources/application.properties.按键设置：

# Database
spring.datasource.url=${SPRING_DATASOURCE_URL:jdbc:h2:file:./data/assistant}
spring.datasource.username=${SPRING_DATASOURCE_USERNAME:sa}
spring.datasource.password=${SPRING_DATASOURCE_PASSWORD:}

# JPA
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=false

# H2 Console (development only)
spring.h2.console.enabled=true

环境变量

将环境变量用于敏感配置：

  • SPRING_DATASOURCE_URL：数据库连接URL
  • SPRING_DATASOURCE_USERNAME：数据库用户名
  • SPRING_DATASOURCE_PASSWORD：数据库密码

项目结构

src/
├── main/
│   ├── java/org/example/ai_assistant/
│   │   ├── AiAssistantApplication.java    # Main entry point
│   │   └── [feature packages]/            # Feature modules
│   └── resources/
│       ├── application.properties         # Configuration
│       ├── db/
│       │   ├── schema.sql                 # Database schema
│       │   └── data.sql                   # Seed data
│       └── files/                         # Helper resources

数据库

应用程序使用H2数据库：

  • 文件位置: ./data/assistant.mv.db
  • 控制台：可在 http://localhost:8080/h2-console （发展）
  • 迁移：通过管理 src/main/resources/db/schema.sql

技术栈

  • Java: 21
  • Spring Boot: 3.5.7
  • 春季AI：1.1.0（MCP服务器支持）
  • 数据库：H2（嵌入式）
  • 生成工具：Maven

资源

相关 MCP