🚀 Spring MCP Server (Jetty + Maven)

A lightweight Model Context Protocol (MCP) Server built using Spring Framework and deployed on Jetty, running as part of a traditional Java web application.

This project enables dynamic tool execution via MCP using annotation-driven registration and a servlet-based request pipeline.

---

📌 Features

• ✅ Custom MCP server implementation
• ✅ Annotation-based tool definitions
• ✅ Servlet-based request handling (/mcp)
• ✅ Maven + Jetty integration
• ✅ Lightweight and deployable as WAR
• ✅ Easy to extend with new tools

---

🛠️ Tech Stack

• Java 17+
• Spring Framework (XML-based configuration)
• Maven
• Jetty Server
• Servlet API

---

📁 Project Structure

src/
 └── main/
     ├── java/com/spring/
     │    ├── mcp/        # MCP core logic
     │    ├── demo/       # Sample controller
     │    └── ...
     ├── resources/
     │    └── spring/     # Spring XML configs
     └── webapp/
          └── WEB-INF/
               └── web.xml

---

▶️ Running Locally

1. Clone the Repository

git clone https://github.com/your-username/your-repo.git
cd your-repo

---

2. Build the Project

mvn clean install

---

3. Run Using Jetty

mvn jetty:run

---

4. Access Application

http://localhost:8080

---

📡 MCP Endpoint

POST /mcp

All MCP requests are handled via:

McpDelegatingServlet

---

🧪 Adding a New Tool

Create a method using annotations:

@McpTool(name = "exampleTool")
public String example(
    @McpToolParam(name = "input") String input
) {
    return "Processed: " + input;
}

That’s it — the tool will be automatically registered at startup.

---

🚀 Deployment

📦 Build WAR File

mvn clean package

WAR file will be generated in:

target/your-app-name.war

---

🌐 Deploy on Jetty (Standalone)

Option 1: Using Jetty Home

1. Copy WAR file:

cp target/your-app-name.war <JETTY_HOME>/webapps/

2. Start Jetty:

java -jar start.jar

---

Option 2: Using Embedded Jetty (Already configured)

mvn jetty:run

---

🐳 Docker Deployment (Optional)

# Build image
docker build -t mcp-server .

# Run container
docker run -p 8080:8080 mcp-server

---

🔗 Detailed Explanation

👉 For deep dive into architecture, tool registration, and MCP flow:

Read Full Blog →

---

🔐 Configuration Notes

• Update Spring configs in:

  • application-context.xml
  • dispatcher-servlet.xml

• Avoid committing sensitive data

---

🧩 Extending the Project

• Add new tools via annotations
• Plug in caching (Redis / Memcached)
• Add authentication layer
• Enable async / streaming execution

---

📄 License

MIT License

---

👨‍💻 Author

Mangesh Patil Backend Engineer | Java | Spring | System Design

---