Solon ile 5 Dakikada İlk MCP Sunucunuzu Oluşturun: Adım Adım Hello World Rehberi

Yapay zeka araçları geliştirme dünyasında MCP (Model Context Protocol) son dönemin en çok konuşulan standartlarından biri. AI modellerinin harici araçlar ve veri kaynaklarıyla etkileşime girmesini sağlayan bu açık protokol, 'AI için USB-C' benzetmesiyle anılıyor. Ancak çoğu geliştirici, sıfırdan bir MCP sunucusu kurmanın karmaşıklığından çekiniyor. Resmi SDK'lar transport katmanları, yetenek görüşmeleri ve araç tanımlamalarıyla uğraşmayı gerektiriyor. İşte tam bu noktada Solon framework fark yaratıyor.

Solon'un yaklaşımı son derece basit: @McpServerEndpoint anotasyonu sayesinde tüm sunucu yapılandırması tek bir sınıfa sığıyor. Bu yazıda, sadece 5 dakikada çalışan bir MCP sunucusu oluşturacak ve temel kavramları adım adım keşfedeceksiniz. Hedefimiz, 8080 portunda çalışan, /mcp endpoint'inde STREAMABLE transport kullanan ve bir 'hello' aracı sunan basit bir sunucu.

İlk adım: projenize Solon MCP bağımlılığını ekleyin. pom.xml dosyanıza yalnızca org.noear ve solon-ai-mcp etiketlerini içeren bir dependency eklemeniz yeterli. Bu tek bağımlılık size sunucu, istemci ve tüm transport türlerini sağlıyor. Ek SDK'lara veya yapılandırma dosyalarına ihtiyaç yok.

Teknik Analiz

İkinci adım: MCP sunucu sınıfınızı oluşturun. Bir Java sınıfına @McpServerEndpoint anotasyonu ekleyin ve channel parametresini McpChannel.STREAMABLE, mcpEndpoint parametresini '/mcp' olarak ayarlayın. Ardından @ToolMapping anotasyonu ile bir hello metodu tanımlayın. Bu metod, @Param anotasyonu ile belirtilen bir 'name' parametresi alır ve 'Hello, [isim]!' döndürür. Tüm anotasyonlar, AI modeline araç hakkında gerekli açıklamaları sağlar.

Üçüncü adım: Uygulamayı başlatın. Solon.start() çağrısı ile Solon'un bileşen tarayıcısı otomatik olarak @McpServerEndpoint anotasyonlu sınıfı bulur ve gerçek bir MCP hizmeti olarak kaydeder. XML yapılandırması, @Bean bildirimi veya ek konfigürasyon sınıfları gerekmez. Sunucu çalıştığında, MCP istemcisi ile bağlanabilirsiniz. McpClientProvider.builder() ile bir istemci oluşturup url parametresine sunucu adresini verin ve callTool metoduyla 'hello' aracını çağırın.

MCP'nin asıl gücü, araçlarınızı bir LLM'ye bağlamakla ortaya çıkar. ChatModel.of() ile bir model oluşturup defaultToolsAdd metoduyla MCP istemcisini ekleyerek, AI modelinin araçlarınızı otomatik olarak kullanmasını sağlayabilirsiniz. Solon MCP, STREAMABLE (modern, önerilen), STREAMABLE_STATELESS (küme dağıtımları için), SSE (eski) ve STDIO (yerel alt süreçler) olmak üzere dört transport türünü destekler. İlk projenizden sonra daha fazla araç ekleyebilir, async sonuçlar döndürebilir, kimlik doğrulama ekleyebilir veya tam bir RAG hattı kurabilirsiniz.

Kaynak: dev.to