Serena MCP Sunucusu Nasıl Kullanılır

Merhaba! Yapay zeka kodlama araçları için para dökmekten sıkıldınız mı? Ücretsiz, açık kaynaklı bir cevher olan ve favori LLM'nizi (Büyük Dil Modeli) cebinizi delmeden bir kodlama gücüne dönüştüren Serena MCP Sunucusu hakkında konuşalım. Oraios AI tarafından geliştirilen Serena, Claude veya açık ağırlıklı modeller gibi araçlarla daha akıllıca kod yazmanızı sağlar ve en iyi yanı ne mi? Ücretsiz kullanabilirsiniz! Bu kılavuzda, Serena'nın ne olduğunu, Claude Code ile bir proje için nasıl kurulacağını ve Serena MCP Sunucusu'nun Claude Desktop ve Cursor'da nasıl kurulacağını ele alacağız. Hadi dalalım ve abonelik ücretlerinden tasarruf edelim!

Serena MCP Sunucusu Nedir?

Serena MCP Sunucusu, Oraios AI'dan gelen ücretsiz, açık kaynaklı bir araç setidir ve herhangi bir büyük dil modelini (LLM) tam teşekküllü bir kodlama aracısına dönüştürür. Anlamsal kod analizi, sembol düzeyinde düzenleme ve çoklu dil desteği (Python, JavaScript, Java ve daha fazlası) gibi IDE benzeri özellikler sağlamak için Model Bağlam Protokolü (MCP) ve Dil Sunucusu Protokolü'nü (LSP) kullanır. Kodu yeniden düzenliyor, büyük kod tabanlarını analiz ediyor veya prototip oluşturuyor olun, Serena planlamadan sürüm kontrolüne değişiklikleri kaydetmeye kadar her şeyi halleder.

Neden harika? Serena, Cursor veya Windsurf gibi pahalı IDE abonelikleri ve Claude Code veya Cline gibi API ağırlıklı araçlarla yaşanan hayal kırıklığından doğdu. Oraios AI, Anthropic'in Claude'u (ücretsiz katmanda bile!) veya Agno aracılığıyla açık ağırlıklı modeller gibi zaten sahip olduğunuz LLM'lerle çalışan ücretsiz bir alternatif istedi. Bu, geliştirici topluluğuna bir armağanları ve kendileri de her gün kullanıyorlar. Ayrıca, MIT lisanslıdır, böylece istediğiniz gibi özelleştirebilirsiniz.

Claude Code ile Bir Projede Serena Kurulumu

MCP sunucularını ücretsiz olarak destekleyen popüler bir kodlama asistanı olan Claude Code'u kullanarak projenizde Serena MCP Sunucusu'nu çalıştıralım. İşte nasıl kurulacağı:

Adım 1: Ön Koşulları Kurun

1. uv Kurun:

• Serena, çalışmak için uv (bir Python paket yöneticisi) kullanır. Şununla kurun:

curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows kullanıcıları için:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Veya Homebrew kullanın: brew install uv.

2. Serena'nın Deposunu Klonlayın:

• Serena kod tabanını GitHub'dan alın:

git clone https://github.com/oraios/serena
cd serena

3. Ortamı Kurun:

• Örnek ortam dosyasını kopyalayın:

cp .env.example .env

• Claude'un ücretsiz katmanı için API anahtarı gerekmez, ancak ücretli bir model kullanıyorsanız anahtarını .env dosyasına ekleyin.

Adım 2: Serena'yı Claude Code için Yapılandırın

1. MCP Sunucusunu Başlatın:

• Serena'nın MCP sunucusunu doğrudan depodan çalıştırın:

uv run serena start-mcp-server

Bu, günlükler ve kapatma için http://localhost:24282/dashboard/index.html adresinde bir web kontrol paneli ile yerel bir sunucu başlatır.

2. Serena'yı Claude Code'a Ekleyin:

• Terminalinizde, Serena'yı Claude Code'a bir MCP sunucusu olarak ekleyin:

claude mcp add-json "serena" '{"command":"uvx","args":["--from","git+https://github.com/oraios/serena","serena-mcp-server"]}'

Bu, Claude Code'a yerel kurulum olmadan Serena'nın MCP sunucusunu kullanmasını söyler.

3. Test Edin:

• Claude Code'u açın, yeni bir konuşma başlatın ve şunu yazın:

Python kod tabanımı ./src içinde analiz et.

• Serena projenizi tarayacak, anılarını .serena/memories/ içinde saklayacak ve ayrıntılı bir analiz sağlayacaktır. Şunu deneyin:

main.py dosyasını async/await kullanacak şekilde yeniden düzenle.

• Serena'nın hassas kod değişiklikleri önermesini izleyin!

Sorun Giderme

• Sunucu Başlamıyor mu? uv'nin kurulu olduğundan ve .env dosyasının ayarlandığından emin olun. Kontrol paneli günlüklerini kontrol edin.
• Claude Code Hataları mı? MCP komut sözdizimini doğrulayın ve Claude Code'u yeniden başlatın.
• İzin Sorunları mı? Göreceli yol hatalarını önlemek için mutlak yollar kullanın (örn. /path/to/serena).

Claude Desktop'ta Serena MCP Sunucusunu Kullanma

Claude Desktop, Claude'un ücretsiz katmanından yararlanarak Serena MCP Sunucusu'nu ücretsiz kullanmanın başka harika bir yoludur. İşte nasıl bağlanacağı:

Adım 1: MCP Sunucusunu Yapılandırın

1. Serena'nın MCP Sunucusunu Çalıştırın:

• Serena depo dizininde sunucuyu başlatın:

uv run serena start-mcp-server

Veya daha temiz bir kurulum için Docker'ı (Deneysel) kullanın:

docker run --rm -i --network host -v /path/to/your/projects:/workspaces/projects ghcr.io/oraios/serena:latest serena start-mcp-server --transport stdio

/path/to/your/projects kısmını projenizin mutlak yolu ile değiştirin.

2. Claude Desktop Yapılandırmasını Düzenleyin:

• Claude Desktop'ın yapılandırma dosyasını açın:
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Serena'nın MCP sunucusunu ekleyin:

{
  "mcpServers": {
    "serena": {
      "command": "/path/to/uv",
      "args": ["run", "--directory", "/path/to/serena", "serena-mcp-server"]
    }
  }
}

/path/to/uv ve /path/to/serena kısımlarını gerçek yollarla değiştirin (Windows'ta çift ters eğik çizgi \\ kullanın).

3. Claude Desktop'ı Yeniden Başlatın:

• Claude Desktop'ı kapatın ve yeniden açın. Serena'nın araçlarının aktif olduğunu gösteren bir çekiç simgesi göreceksiniz.

Adım 2: Claude Desktop'ta Serena'yı Test Edin

1. Bir Konuşma Başlatın:

• Claude Desktop'ta şunu yazın:

./myproject içindeki projemi özetle.

• Serena kod tabanınızı analiz edecek ve LSP destekli anlamsal anlayışını kullanarak bir özet döndürecektir.

2. Kodlama Görevlerini Deneyin:

• Şunu sorun:

src/app.js'deki hataları günlüklere göre düzelt.

• Serena, günlüklerden ve projenin .serena/memories/ içindeki hafızasından yararlanarak düzeltmeler önerecektir.

3. Kontrol Panelini Kontrol Edin:

• Günlükleri izlemek veya sunucuyu kapatmak için http://localhost:24282/dashboard/index.html adresini ziyaret edin.

İpuçları

• Günlüğü Etkinleştirin: Daha kolay hata ayıklama için myproject.yml içinde show_logs: true ayarlayın.
• Sürüm Kontrolü: Bellek dosyalarını kaydetmemek için .serena'yı .gitignore'a ekleyin.
• Güvenlik: İstenmeyen eylemleri önlemek için Agno modunda onay olmadan execute_shell_command kullanmaktan kaçının.

Cursor'da Serena MCP Sunucusunu Kullanma

Cursor, şık bir yapay zeka destekli IDE'dir ve Serena MCP Sunucusu'nu Cursor ile global olarak veya proje bazında kullanabilirsiniz. İşte nasıl yapılacağı:

Adım 1: Serena'nın MCP Sunucusunu Kurun

1. Sunucuyu Başlatın:

• Daha önce olduğu gibi, şunu çalıştırın:

uv run serena start-mcp-server

Veya Claude Desktop bölümündeki Docker komutunu kullanın.

2. Cursor'ı Global Olarak Yapılandırın:

• ~/.cursor/mcp.json dosyasını ("Araçlar ve Entegrasyonlar" bölümünün altında) açın:

{
  "mcpServers": {
    "serena": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/oraios/serena", "serena-mcp-server"]
    }
  }
}

Bu, Serena'yı tüm Cursor projelerinde kullanılabilir hale getirir.

3. Veya Proje Başına Yapılandırın:

• Projenizin kök dizininde, yukarıdakiyle aynı yapılandırmaya sahip .cursor/mcp.json dosyasını oluşturun.

4. Cursor'ı Yeniden Başlatın:

• Değişiklikleri uygulamak için Cursor'ı kapatın ve yeniden açın.

Adım 2: Cursor'da Serena'yı Test Edin

1. Cursor'ın Sohbet Panelini Açın:

• Bir projede sohbet panelini açın ve şunu yazın:

src/api.py içinde bir REST API oluştur.

• Serena, projenizin yapısına uygun olarak kod oluşturacaktır.

2. Kodu Yeniden Düzenleyin:

• Kodu vurgulayın, Ctrl+L (veya macOS'ta Cmd+L) tuşlarına basın ve şunu girin:

Bu fonksiyonu performans için optimize et.

• Serena iyileştirmeler önerecektir, ancak Pro aboneliği olmadan Düzenleme modunun sınırlı olabileceğini unutmayın.

3. Günlükleri Kontrol Edin:

• Sorun gidermek için web kontrol panelini (http://localhost:24282/dashboard/index.html) kullanın.

Neden Serena MCP Sunucusunu Kullanmalı?

Serena MCP Sunucusu, abonelik maliyetlerinden bıkan geliştiriciler için bir cankurtarandır. İşte neden harika:

• Sonsuza Kadar Ücretsiz: Claude'un ücretsiz katmanıyla veya Agno aracılığıyla açık ağırlıklı modellerle çalışır, API anahtarına gerek yoktur.
• Güçlü Özellikler: Anlamsal kod alma, sembol düzeyinde düzenlemeler ve çoklu dil desteği, Cursor gibi ücretli araçlarla rekabet eder.
• Gizlilik Dostu: Yerel olarak çalışır, kod tabanınızı üçüncü taraf sunuculardan uzak tutar.
• Topluluk Odaklı: 2.9 binden fazla GitHub yıldızı ve aktif geliştirme ile Serena hızla gelişiyor.

Kullanıcılar Serena hakkında vızıldıyor, bazıları Claude ile eşleştirildiğinde onu "en güçlü kodlama kurulumu" olarak adlandırıyor. İster tek başına bir geliştirici olun ister bir ekibin parçası olun, Serena pahalı abonelikleri iptal etmenizi ve daha akıllıca kod yazmanızı sağlar. Yakında, ChatGPT Desktop MCP sunucularını destekleyebilir ve seçeneklerinizi daha da genişletebilir.

Sonuç

Serena MCP Sunucusu, Claude Code, Claude Desktop ve Cursor gibi araçlarla ücretsiz, yapay zeka destekli kodlamaya biletinizdir. Serena'yı kurmaktan favori düzenleyicinizde çalıştırmaya kadar, artık abonelik baş ağrıları olmadan kodlama görevlerini üstlenmeye hazırsınız. Bir deneyin, web kontrol panelini keşfedin ve iş akışınızı hızlandırmak için Serena'yı nasıl kullandığınızı yorumlarda bana bildirin!