MCP Server kurmak, bir Yapay Zeka modelinin (örneğin Claude'un) senin verilerine ve dış sistemlerine güvenli ve kurallı bir şekilde bağlanmasını sağlayan standart bir köprü (adaptör) ayağa kaldırmaktır. Nasıl ki veritabanına bağlanmak için JDBC standardı varsa, LLM'lerin dış dünyayla konuşması için de Model Context Protocol (MCP) bir standarttır.
Kafandaki "Kürbnetes MCP server hazır vardır da benim Spring app bana özel, onu nasıl yapacağız?" ikilemini ve işin mekaniğini şu şekilde özetleyebiliriz:
1. Hazır / Standart MCP Server'lar Nedir?
Kubernetes, GitHub, PostgreSQL veya dosya sistemi gibi genel geçer teknolojiler için dünyada birileri (Anthropic veya açık kaynak topluluğu) zaten genel amaçlı MCP sunucuları yazmıştır. Bunları doğrudan alır (örneğin bir npx komutu veya Docker container olarak) ve Claude Desktop gibi bir istemciye yapılandırıp geçersin. Bunlar evrenseldir, herkese açıktır.
2. Senin Spring Boot Uygulaman (Bana Özel)
Senin şirket içi iş kurallarını barındıran, kendi PostgreSQL veritabanına sorgu atan veya özel mikroservislerinle konuşan backend uygulamanı dış dünyadaki hazır bir K8s MCP server bilemez. Claude'un senin özel iş mantığını çalıştırabilmesi için, senin Spring Boot uygulamanın kendisini bir MCP Server'a dönüştürmen gerekir.
3. Kendi Spring App'ini Nasıl MCP Server Yaparsın? (Framework Desteği)
Artık bu iş için tekerleği yeniden keşfetmeye gerek yok. Spring AI kütüphanesi, Java dünyasında tam bu iş için yerleşik MCP Server desteği (spring-ai-starter-mcp-server-webmvc vb.) sunar.
Senin kod tarafında yapman gerekenler sadece şunlardan ibarettir:
- Bağımlılığı Ekle: Projene Spring AI MCP Server starter'ını ekle.
- Metodu İşaretle (
@Tool): Spring Service katmanındaki herhangi bir metoda@Toolannotasyonu koyarsın:@Service public class OrderService { @Tool(name = "get_customer_orders", description = "Fetches active orders for a given customer ID from the database") public List<Order> getCustomerOrders(String customerId) { // Kendi özel business logic'in ve DB sorgun return orderRepository.findByCustomerId(customerId); } } - Protokolü Yönetir: Spring AI arka planda JSON-RPC protokolünü, SSE (Server-Sent Events) veya HTTP transport katmanını yönetir. Claude (veya herhangi bir MCP Client) senin uygulamana bağlandığında, hangi araçların (
tools) olduğunu otomatik olarak keşfeder (tools/list).
Kullanıcı Claude'a "Serkan'ın son siparişleri neler?" diye sorduğunda, Claude arka planda senin Spring uygulamandaki getCustomer_orders metodunu JSON-RPC ile tetikler, veriyi alır ve kullanıcıya anlaşılır dille raporlar. Yani kendi uygulamanı birkaç satır annotasyonla birer AI aracına (Tool) dönüştürmüş olursun.
Model Context Protocol with Spring AI tutorial Bu video, Spring Boot uygulamalarını MCP sunucusuna dönüştürme sürecini pratik bir örnekle görsel olarak anlaman için faydalı olacaktır.
.png)