# Cara memilih pelayan MCP kecerdasan kod

Canonical source: https://maguyva.ai/ms/guides/choosing-a-code-intelligence-mcp-server

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Pilih pelayan yang menjawab soalan sebenar ejen anda tentang kod anda sendiri: di mana sesuatu simbol ditakrifkan, siapa yang memanggilnya, apa yang rosak jika ia berubah, dan di mana letaknya sesuatu konsep yang namanya sudah tiada siapa ingat.

Ini memerlukan beberapa jenis carian, penghuraian sebenar bagi bahasa yang anda gunakan, indeks yang seiring dengan commit anda, dan persediaan yang boleh disiapkan oleh klien anda dalam beberapa minit. Jalankan ujian 15 minit di bawah pada repositori yang anda kenali: ia lebih boleh dipercayai daripada mana-mana senarai ciri, termasuk yang ini.

## Perkara yang perlu dibandingkan

Tanya setiap calon soalan yang sama, kemudian semak jawapannya pada kod anda sendiri. Senarai ciri hanyalah dakwaan; jawapan yang betul pada repositori anda ialah bukti.

| Kriteria | Apa yang perlu ditanya | Cara menyemaknya |
|---|---|---|
| **Mod carian** | Adakah ia menggabungkan carian semantik, struktur (AST), graf dan teks tepat, serta menghala setiap soalan ke mod yang betul? Satu mod sahaja meninggalkan seluruh kelas soalan tanpa jawapan. | Tanya satu soalan bagi setiap jenis: satu konsep, satu bentuk kod, senarai pemanggil dan mesej ralat yang tepat. |
| **Kedalaman sokongan bahasa** | Bagi setiap bahasa yang anda gunakan, adakah kodnya dihuraikan menjadi AST dengan simbol dan hubungan, atau hanya diindeks sebagai teks? Senarai bahasa yang panjang boleh menyembunyikan sokongan yang cetek. | Cari bendera keupayaan yang diterbitkan untuk bahasa anda, kemudian cari satu simbol dalam setiap bahasa. |
| **Skala repositori** | Adakah ia mampu mengendalikan repositori terbesar anda dan beberapa repositori serentak? Adakah hasil kekal disusun dan terhad, atau satu fail besar membanjiri jawapan? | Indeks repositori sebenar anda yang terbesar, bukan projek demo, dan ukur masa hingga jawapan berguna yang pertama. |
| **Kesegaran dan penyegerakan** | Bagaimanakah indeks mengetahui tentang commit baharu, dan berapa lama sebelum sesuatu perubahan boleh dicari? Indeks yang lapuk menjawab dengan yakin tentang kod yang sudah tiada. | Commit satu penukaran nama, kemudian cari nama baharu dan nama lama. |
| **Keselamatan dan pengendalian data** | Di mana kod sumber anda disimpan, apa yang dihantar kepada pihak ketiga, adakah ia digunakan untuk latihan, dan apa yang dipadam apabila anda memutuskan sambungan? | Baca halaman pengendalian data. Cari penyedia yang dinamakan dan peraturan pemadaman yang konkrit, bukan lencana. |
| **Persediaan setiap klien** | Adakah terdapat konfigurasi berdokumen untuk setiap klien yang digunakan pasukan anda, dan adakah satu endpoint melayani kesemuanya? | Sambungkan dua klien yang sudah digunakan pasukan anda dan ukur masa kedua-duanya. |
| **Model harga** | Adakah harganya awam? Adakah anda membayar mengikut tempat duduk, ejen atau ruang kerja, dan adakah peringkat percuma cukup untuk percubaan sebenar? | Kira harga persediaan sebenar anda: ejen, repositori dan baris terindeks yang betul-betul akan anda jalankan. |
| **Bukti pada kod anda** | Bolehkah anda mengujinya hari ini pada repositori anda sendiri, tanpa panggilan jualan? | Jika percubaan memerlukan mesyuarat dahulu, itu juga satu jawapan. |

### Di mana indeks berada

Di mana indeks berada kurang penting berbanding apa yang boleh dijawabnya. Ejen anda memerlukan fail, simbol dan senarai pemanggil yang betul pada saat ia merancang suntingan, jadi nilai setiap calon dengan soalan di atas, ditanya pada kod anda sendiri.

## Uji pada repo anda dalam 15 minit

Gunakan repositori yang anda kenali dengan baik, supaya setiap jawapan boleh dinilai sepintas lalu. Kira jawapan yang terpaksa anda betulkan.

1. Sambungkan repositori dan catat berapa lama sebelum carian pertama memulangkan hasil.
2. Tanya soalan konsep yang tidak berkongsi kata kunci dengan kod, contohnya "di mana kita mengendalikan sesi yang tamat tempoh?" Buka setiap fail dan baris yang dipetik.
3. Cari satu simbol mengikut nama, kemudian tanya siapa pemanggilnya. Bandingkan senarai itu dengan apa yang anda tahu.
4. Pilih fungsi yang anda rancang untuk diubah dan tanya apa yang bergantung padanya. Senarai itulah lingkungan impaknya: padankan dengan ujian yang akan mengesan kerosakan.
5. Tanya tentang bentuk kod dan bukannya nama, contohnya setiap pengendali laluan atau setiap kelas yang melaksanakan antara muka tertentu.
6. Cari rentetan tepat, seperti mesej ralat, dan pastikan setiap padanan adalah benar.
7. Commit penukaran nama yang kecil, tunggu indeks mengejar, dan cari kedua-dua nama.
8. Kira pembetulan. Pelayan yang paling sedikit memerlukannya menang, walau apa pun kata senarai cirinya.

## Istilah dan takrifannya

- **Pelayan MCP kecerdasan kod**: Pelayan MCP yang mengindeks kod sumber dan mendedahkannya kepada ejen AI sebagai alat. Daripada menampal seluruh fail ke dalam prompt, ejen bertanya soalan dan menerima hasil yang disusun mengikut kedudukan bersama laluan fail dan nombor baris.
- **Graf kod**: Peta tentang cara simbol, fail dan modul bersambung: takrifan, rujukan, panggilan, import dan pewarisan. Ia menjawab "siapa yang menggunakan ini?" tanpa membaca setiap fail.
- **Lingkungan impak (blast radius)**: Kod yang mungkin terjejas apabila sesuatu simbol berubah: pemanggilnya, dependennya dan ujian yang meliputinya. Mengetahuinya sebelum menyunting ialah tujuan carian graf.
- **Carian AST**: Carian pada abstract syntax tree, iaitu struktur kod yang telah dihuraikan. Ia mencari kod mengikut bentuk, contohnya setiap fungsi dengan decorator tertentu, sesuatu yang tidak dapat dilakukan dengan boleh dipercayai oleh carian teks biasa.
- **Carian semantik**: Carian mengikut makna menggunakan embedding. Ia menemui kod yang sepadan dengan sesuatu penerangan walaupun kod dan soalan tidak berkongsi sepatah perkataan pun.
- **Carian teks tepat**: Padanan literal atau ungkapan nalar. Alat yang sesuai untuk mesej ralat, kunci konfigurasi dan pengecam yang sudah anda ketahui.

## Kedudukan Maguyva

Maguyva ialah pelayan MCP kecerdasan kod yang dihoskan. Ia mengindeks repositori GitHub yang anda sambungkan dan memberikan ejen anda 11 alat MCP, dengan setiap hasil disertakan laluan fail.

- **Carian**: Carian semantik, struktur, graf dan teks tepat, ditambah carian simbol dan alat penghala yang memilih mod yang betul untuk setiap soalan. (`intelligent_search`, `semantic_search`, `structural_search`, `text_pattern_search`, `find_symbol`, `dependency_search`, `analyze_dependencies`)
- **Bahasa**: 285 bahasa dan format teks diindeks: 247 dengan carian struktur berasaskan AST, 282 dengan pengekstrakan simbol dan 151 dengan hubungan graf. Kedalaman berbeza mengikut bahasa, jadi semak bahasa anda.
- **Kesegaran**: Indeks dikemas kini melalui tugas penyegerakan GitHub apabila kod berubah.
- **Persediaan**: Satu endpoint MCP jauh, dengan konfigurasi langkah demi langkah untuk 23 klien berdokumen.
- **Harga**: Awam, dan mengikut ruang kerja, bukan tempat duduk. Pelan Free meliputi 3 repositori dan 50,000 baris terindeks, cukup untuk ujian 15 minit.
- **Pengendalian data**: Halaman keselamatan menyatakan apa yang disimpan dan di mana, apa yang dihantar untuk embedding dan apa yang dipadam apabila anda memutuskan sambungan.

Buat masa ini repositori disambungkan dari GitHub. Jika kod anda berada di tempat lain, semak halaman keserasian sebelum bermula.

- [Mulakan quickstart](https://maguyva.ai/ms/docs/quickstart)
- [Lihat harga](https://maguyva.ai/ms/pricing)
- [Semak keupayaan setiap bahasa](https://maguyva.ai/ms/docs/compatibility)
- [Baca butiran pengendalian data](https://maguyva.ai/ms/security)