项目简介

Infobip OpenAPI MCP是一个基于Spring Boot和Spring AI的框架，专门用于将现有的OpenAPI文档描述的HTTP API自动转换为符合MCP协议的服务器。它简化了将传统API暴露给AI智能体使用的过程，同时提供了完善的安全控制和定制选项。

主要功能

• 自动工具映射：将HTTP API的操作路径和方法转换为MCP工具
• 输入参数适配：自动处理路径参数、查询参数和请求体参数的标准化
• 安全认证支持：完整支持OAuth、API密钥等多种认证方式
• 智能JSON处理：自动检测和修复客户端发送的JSON格式错误
• 可定制工具命名：支持多种命名策略和长度限制
• OpenAPI规范过滤：允许编程方式定制API规格
• 请求增强：支持自定义HTTP请求头和处理逻辑
• 会话管理：支持有状态和无状态两种传输协议

安装步骤

1. 环境要求：Java 21或更高版本，Spring Boot 3.5.x，Spring AI 1.1.x

2. 添加依赖：

使用Maven：

<dependency>
    <groupId>com.infobip.openapi.mcp</groupId>
    <artifactId>infobip-openapi-mcp-spring-boot-starter</artifactId>
<version>0.1.2</version>
</dependency>

或使用Gradle：
```groovy
implementation("com.infobip.openapi.mcp:infobip-openapi-mcp-spring-boot-starter:0.1.2

3. 配置传输协议：

对于Stdio传输（推荐）：

spring:
  ai:
    mcp:
      server:
        type: sync
        stdio: on

服务器配置

MCP客户端需要配置以下信息来连接该服务器：

{
  "mcpServers": {
    "您的服务器名称": {
      "command": "java",
      "args": ["-jar", "您的应用jar文件"]

基本使用方法

1. 配置OpenAPI源：在配置文件中指定OpenAPI文档的URL

2. 设置API基础URL：配置后端API的实际地址

3. 启用认证（可选）：设置安全验证端点

4. 自定义工具：通过实现过滤器或增强器来调整API行为

5. 启动应用：运行Spring Boot应用，MCP服务器将自动启动

6. 连接客户端：配置MCP客户端连接到您的服务器