api2mcp4j

概述

api2mcp4j 是一个创新的 Spring Boot 扩展，使开发者能够将现有 REST API 作为 MCP 工具暴露，而无需大量代码更改。项目自动扫描 @RestController 和 @Service Bean，利用 Swagger/OpenAPI、Javadoc 和 Spring MVC 元数据中的信息来生成 MCP 工具定义。这种非侵入式方法允许快速将 AI 功能集成到现有 Java 应用程序中，同时保持业务逻辑完整性。项目支持自定义注解进行精细控制，并与最新的 MCP Java SDK 功能兼容，包括回调、资源和提示。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• auto-discover_controllersvoid discoverControllers()

  Automatically scans and registers all controller methods as MCP tools

  试试:Automatically scan my REST controllers for MCP tools试试:Discover all available endpoints in my application
• parse_swaggervoid parseSwagger(String apiPath)

  Parse Swagger/OpenAPI documentation to generate MCP tool descriptions

  试试:Use my Swagger documentation to create tool descriptions试试:Parse my OpenAPI spec for better tool metadata
• parse_javadocvoid parseJavadoc(String sourcePath)

  Extract Java documentation comments for tool descriptions

  试试:Use Javadoc comments to describe my tools试试:Generate tool descriptions from source code comments
• configure_mcp_servervoid configureMcpServer(Config config)

  Configure MCP server with custom settings and parser combinations

  试试:Configure my MCP server to use multiple parsers试试:Set up auto-discovery for all my REST endpoints

说明：Tool names were inferred from the features described in the README, as actual tool names weren't explicitly listed. The server exposes automatic discovery and parsing capabilities rather than specific named tools.

可对比工具

安装

git clone https://github.com/TheEterna/api2mcp4j.git
cd api2mcp4j/server2mcp-starter-webmvc
mvn clean install

<dependency>
    <groupId>com.ai.plug</groupId>
    <artifactId>server2mcp-starter-webmvc</artifactId>
    <version>1.1.4-SNAPSHOT</version>
</dependency>

plugin:
  mcp:
    enabled: true
    parser:
      params: SWAGGER3, SWAGGER2, SpringMVC, JACKSON, TOOL
      des:    SWAGGER3, SWAGGER2, JAVADOC, TOOL, JACKSON
    scope: interface

FAQ

api2mcp4j 相比传统 MCP 实现的主要优势是什么？

主要优势是零低代码集成 - 它能自动将现有 REST API 转换为 MCP 工具，无需手动添加 @Tool 注解或重构代码。

api2mcp4j 支持所有 Spring Boot 版本吗？

api2mcp4j 专为 Spring Boot 3.x 设计，需要 Java 17 或更高版本以保持兼容性。

我可以组合多个解析器以获得更好的工具描述吗？

是的，项目支持组合多个解析器，包括 Swagger/OpenAPI、Javadoc、Spring MVC 元数据、Jackson 和自定义注解，以获得全面的工具描述。

api2mcp4j 对比