Cara Menggunakan Server Serena MCP

Hai! Bosan menghabiskan uang untuk alat bantu pengkodean AI? Mari kita bahas **Serena MCP Server**, sebuah permata sumber terbuka gratis yang mengubah LLM favorit Anda menjadi pusat kekuatan pengkodean, semuanya tanpa menguras dompet. Dibangun oleh Oraios AI, Serena memungkinkan Anda mengkode lebih cerdas dengan alat seperti Claude atau model *open-weight*, dan bagian terbaiknya? Anda bisa menggunakannya secara gratis! Dalam panduan ini, kami akan membahas apa itu Serena, cara menginstalnya untuk proyek dengan Claude Code, dan cara menyiapkan **Serena MCP Server** di Claude Desktop dan Cursor. Mari kita selami dan hemat biaya langganan Anda!

Apa Itu Serena MCP Server?

**Serena MCP Server** adalah *toolkit* sumber terbuka gratis dari Oraios AI yang mengubah model bahasa besar (LLM) apa pun menjadi agen pengkodean yang lengkap. Ini menggunakan Model Context Protocol (MCP) dan Language Server Protocol (LSP) untuk menyediakan fitur-fitur seperti IDE, seperti analisis kode semantik, pengeditan tingkat simbol, dan dukungan multi-bahasa (Python, JavaScript, Java, dan lainnya). Baik Anda melakukan *refactoring* kode, menganalisis *codebase* besar, atau membuat prototipe, Serena menangani semuanya—mulai dari perencanaan hingga *commit* perubahan ke kontrol versi.

Mengapa ini luar biasa? Serena lahir dari frustrasi terhadap langganan IDE yang mahal seperti Cursor atau Windsurf dan alat yang berat API seperti Claude Code atau Cline. Oraios AI menginginkan alternatif gratis yang berfungsi dengan LLM yang sudah Anda miliki, seperti Claude dari Anthropic (bahkan pada tingkatan gratis!) atau model *open-weight* melalui Agno. Ini adalah hadiah mereka untuk komunitas pengembang, dan mereka menggunakannya sendiri setiap hari. Ditambah lagi, ini berlisensi MIT, jadi Anda bisa menyesuaikannya sesuka hati.

Menginstal Serena dalam Proyek dengan Claude Code

Mari kita jalankan **Serena MCP Server** di proyek Anda menggunakan **Claude Code**, asisten pengkodean populer yang mendukung server MCP secara gratis. Berikut cara menyiapkannya:

Langkah 1: Instal Prasyarat

1. Instal uv:

• Serena menggunakan uv (*package manager* Python) untuk berjalan. Instal melalui:

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

# For windows users:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Atau gunakan Homebrew: brew install uv.

2. Kloning Repositori Serena:

• Ambil *codebase* Serena dari GitHub:

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

3. Siapkan Lingkungan:

• Salin file lingkungan contoh:

cp .env.example .env

• Tidak diperlukan kunci API untuk tingkatan gratis Claude, tetapi jika menggunakan model berbayar, tambahkan kuncinya ke .env.

Langkah 2: Konfigurasi Serena untuk Claude Code

1. Mulai Server MCP:

• Jalankan server MCP Serena langsung dari repositori:

uv run serena start-mcp-server

Ini akan memulai server lokal dengan *dashboard* web di http://localhost:24282/dashboard/index.html untuk *log* dan *shutdown*.

2. Tambahkan Serena ke Claude Code:

• Di terminal Anda, tambahkan Serena sebagai server MCP ke Claude Code:

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

Ini memberi tahu Claude Code untuk menggunakan server MCP Serena tanpa instalasi lokal.

3. Uji Coba:

• Buka Claude Code, mulai percakapan baru, dan ketik:

Analisis *codebase* Python saya di ./src.

• Serena akan memindai proyek Anda, menyimpan memori di .serena/memories/, dan memberikan analisis terperinci. Coba:

*Refactor* main.py untuk menggunakan async/await.

• Saksikan Serena menyarankan perubahan kode yang tepat!

Penyelesaian Masalah

• Server Tidak Mau Menyala? Pastikan uv terinstal dan file .env telah disiapkan. Periksa *log dashboard*.
• Error Claude Code? Verifikasi sintaks perintah MCP dan mulai ulang Claude Code.
• Masalah Izin? Gunakan jalur absolut (misalnya, /path/to/serena) untuk menghindari kesalahan jalur relatif.

Menggunakan Serena MCP Server di Claude Desktop

**Claude Desktop** adalah cara hebat lain untuk menggunakan **Serena MCP Server** secara gratis, memanfaatkan tingkatan gratis Claude. Berikut cara menyambungkannya:

Langkah 1: Konfigurasi Server MCP

1. Jalankan Server MCP Serena:

• Di direktori repo Serena, mulai server:

uv run serena start-mcp-server

Atau gunakan Docker (Eksperimental) untuk penyiapan yang lebih bersih:

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

Ganti /path/to/your/projects dengan jalur absolut proyek Anda.

2. Edit Konfigurasi Claude Desktop:

• Buka file konfigurasi Claude Desktop:
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Tambahkan server MCP Serena:

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

Ganti /path/to/uv dan /path/to/serena dengan jalur sebenarnya (gunakan *double backslash* \\ di Windows).

3. Mulai Ulang Claude Desktop:

• Tutup dan buka kembali Claude Desktop. Anda akan melihat ikon palu yang menunjukkan alat Serena aktif.

Langkah 2: Uji Coba Serena di Claude Desktop

1. Mulai Percakapan:

• Di Claude Desktop, ketik:

Ringkas proyek saya di ./myproject.

• Serena akan menganalisis *codebase* Anda dan mengembalikan ringkasan, menggunakan pemahaman semantik yang didukung LSP.

2. Coba Tugas Pengkodean:

• Tanyakan:

Perbaiki *bug* di src/app.js berdasarkan *log*.

• Serena akan menyarankan perbaikan, berdasarkan *log* dan memori proyeknya di .serena/memories/.

3. Periksa Dashboard:

• Kunjungi http://localhost:24282/dashboard/index.html untuk memantau *log* atau mematikan server.

Tips

• Aktifkan Logging: Di myproject.yml, atur show_logs: true untuk *debugging* yang lebih mudah.
• Kontrol Versi: Tambahkan .serena ke .gitignore untuk menghindari *commit* file memori.
• Keamanan: Hindari execute_shell_command dalam mode Agno tanpa konfirmasi untuk mencegah tindakan yang tidak disengaja.

Menggunakan Serena MCP Server di Cursor

**Cursor** adalah IDE bertenaga AI yang apik, dan Anda dapat menggunakan **Serena MCP Server** dengan Cursor secara global atau per proyek. Berikut caranya:

Langkah 1: Siapkan Server MCP Serena

1. Mulai Server:

• Seperti sebelumnya, jalankan:

uv run serena start-mcp-server

Atau gunakan perintah Docker dari bagian Claude Desktop.

2. Konfigurasi Cursor Secara Global:

• Buka ~/.cursor/mcp.json (di bawah bagian "Tools and Integrations"):

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

Ini membuat Serena tersedia di semua proyek Cursor.

3. Atau Konfigurasi Per Proyek:

• Di *root* proyek Anda, buat .cursor/mcp.json dengan konfigurasi yang sama seperti di atas.

4. Mulai Ulang Cursor:

• Tutup dan buka kembali Cursor untuk menerapkan perubahan.

Langkah 2: Uji Coba Serena di Cursor

1. Buka Panel Obrolan Cursor:

• Dalam sebuah proyek, buka panel obrolan dan ketik:

Buat REST API di src/api.py.

• Serena akan membuat kode, menghormati struktur proyek Anda.

2. Refactor Kode:

• Sorot kode, tekan Ctrl+L (atau Cmd+L di macOS), dan masukkan:

Optimalkan fungsi ini untuk kinerja.

• Serena akan menyarankan perbaikan, tetapi perhatikan bahwa mode Edit mungkin terbatas tanpa langganan Pro.

3. Periksa Log:

• Gunakan *dashboard* web (http://localhost:24282/dashboard/index.html) untuk memecahkan masalah.

Mengapa Menggunakan Serena MCP Server?

**Serena MCP Server** adalah penyelamat bagi para pengembang yang bosan dengan biaya langganan. Inilah mengapa ini luar biasa:

• Gratis Selamanya: Berfungsi dengan tingkatan gratis Claude atau model *open-weight* melalui Agno, tidak perlu kunci API.
• Fitur Canggih: Pengambilan kode semantik, pengeditan tingkat simbol, dan dukungan multi-bahasa menyaingi alat berbayar seperti Cursor.
• Ramah Privasi: Berjalan secara lokal, menjaga *codebase* Anda dari server pihak ketiga.
• Didorong Komunitas: Dengan 2.9k+ bintang GitHub dan pengembangan aktif, Serena berkembang pesat.

Pengguna sangat antusias dengan Serena, dengan beberapa menyebutnya “pengaturan pengkodean terkuat” saat dipasangkan dengan Claude. Baik Anda pengembang solo atau dalam tim, Serena memungkinkan Anda membatalkan langganan mahal tersebut dan mengkode lebih cerdas. Segera, ChatGPT Desktop mungkin akan mendukung server MCP, memperluas pilihan Anda lebih jauh.

Kesimpulan

**Serena MCP Server** adalah tiket Anda untuk pengkodean bertenaga AI gratis dengan alat seperti Claude Code, Claude Desktop, dan Cursor. Mulai dari menginstal Serena hingga menjalankannya di editor favorit Anda, kini Anda siap untuk menangani tugas pengkodean tanpa pusing karena langganan. Cobalah, jelajahi *dashboard* web-nya, dan beri tahu saya di komentar bagaimana Anda menggunakan Serena untuk mempercepat alur kerja Anda!