Skip to main content
api2mcp4j - AI Agents | SkillsLLM
Home AI Agents api2mcp4j Spring Boot Starter: Auto-convert existing REST APIs (@RestController) to MCP Server with zero/low-code. Expose controllers as MCP Tools instantly.
agent ai framework java maven
# Add to your Claude Code skills
git clone https://github.com/TheEterna/api2mcp4japi2mcp4j
Zero-to-low code MCP integration for your Spring Boot REST APIs no @Tool annotations everywhere , no rewriting business logic.
✨ Why api2mcp4j?
Most MCP integrations require you to:
Add @Tool / @McpTool annotations to every method
Duplicate or heavily refactor code
Maintain separate tool descriptions
api2mcp4j changes that.
It automatically scans your existing @RestController / @Service beans and exposes them as MCP tools with minimal configuration — leveraging parsers from:
Swagger/OpenAPI (v2 & v3)
Javadoc
Spring MVC metadata
Jackson
Spring AI native descriptions
Custom @Tool / @McpTool (optional)
Result: Your current REST APIs become AI-callable tools almost for free .
🔥 Key Features
Sign in with GitHub to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
mcp
mcp-server
multi-agent-systems
spring
spring-ai
spring-boot
spring-mvc
Non-intrusive — No need to change business code (like MyBatis-Plus enhances MyBatis)
Auto-discovery — Scans controllers/services and registers methods as MCP tools
Multi-parser support — Smartly combines descriptions & parameter info from Swagger, Javadoc, etc.
Custom annotations — @ToolScan, @ResourceScan, @PromptScan for fine-grained control
Isolated MCP tool system — Uses McpTool annotation (independent of Spring AI @Tool)
Full MCP SDK compatibility — Supports latest MCP Java SDK features (callbacks, resources, prompts)
Easy debugging — Works great with Cursor, Continue, or any MCP client
Quick Start (≈ 5 minutes)
1. Add dependency
Note: Project not yet in Maven Central — build from source for now.
# Clone & build
git clone https://github.com/TheEterna/api2mcp4j.git
cd api2mcp4j/server2mcp-starter-webmvc
mvn clean install
<!-- pom.xml -->
<dependency>
<groupId>com.ai.plug</groupId>
<artifactId>server2mcp-starter-webmvc</artifactId>
<version>1.1.4-SNAPSHOT</version> <!-- or latest after build -->
</dependency>
2. Enable in application.yml plugin:
mcp:
enabled: true
# Recommended: use multiple parsers for best description quality
parser:
params: SWAGGER3, SWAGGER2, SpringMVC, JACKSON, TOOL # JAVADOC needs extra setup
des: SWAGGER3, SWAGGER2, JAVADOC, TOOL, JACKSON
# 'interface' = auto-register all controller methods (skip @Deprecated)
# 'custom' = only register via @ToolScan / manual
scope: interface
3. (Optional) Javadoc parser setup To enable Javadoc parsing in production (bytecode doesn't contain comments):
<!-- pom.xml - package sources -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<executions>
<execution>
<id>copy-java-sources</id>
<phase>prepare-package</phase>
<goals><goal>copy-resources</goal></goals>
<configuration>
<outputDirectory>${project.build.outputDirectory}</outputDirectory>
<resources>
<resource>
<directory>src/main/java</directory>
<includes><include>**/*.java</include></includes>
</resource>
</resources>
</configuration>
</execution>
</executions>
</plugin>
4. Start your app → Test Your MCP endpoint is ready (default /mcp or configured via spring.ai.mcp.* properties).
Use any MCP client (Cursor, custom agent, etc.) to call your original REST methods as tools.
Comparison with Alternatives | Feature | api2mcp4j | Spring AI MCP Official | Manual @Tool everywhere |
|-----------------------------|--------------------|------------------------|--------------------------|
| Code changes required | Minimal (config only) | Medium–High | High |
| Auto from existing REST | Yes (controllers) | No | No |
| Parser combinators | Yes (Swagger+Javadoc+…) | Limited | Manual |
| Non-intrusive | ★★★★★ | ★★★ | ★☆ |
| Custom scan annotations | Yes | Partial | No |
| Best for existing projects | Yes | New MCP-first apps | Small prototypes |
Best Use Cases
Expose internal management system APIs to AI agents quickly
Build multi-agent systems by turning microservices into MCP tools
Prototype AI features on top of production REST services
Avoid duplicating logic between REST and MCP endpoints
Documentation & Roadmap
Contributing Issues, PRs, and stars are very welcome!
License
作者的话
- 语言更流畅、专业、吸引人
你可以直接发给作者，建议他 review 后合并（或作为 PR）。如果需要，我可以再调整语气、加 GIF/demo 图位置提示，或写中文版。
56,409
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
AI Agents ai-agents anthropic
An open-source AI agent that brings the power of Gemini directly into your terminal.
AI Agents ai ai-agents
Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors
MCP Servers llm mcp
⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载，你的 AI 舆情监控助手与热点筛选工具！聚合多平台热点 + RSS 订阅，支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机，也支持接入 MCP 架构，赋能 AI 自然语言对话分析、情感洞察与趋势预测等。支持 Docker ，数据本地/云端自持。集成微信/飞书/钉钉/Telegram/邮件/ntfy/bark/slack 等渠道智能推送。
MCP Servers ai bark
A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
AI Agents agent-skills ai-agents
