FAQ MCP - AI Coding Assistant Lingma

Dokumen ini menjelaskan cara menangani pengecualian selama instalasi dan operasi server MCP, termasuk lingkungan yang hilang, kegagalan inisialisasi layanan, serta kesalahan konfigurasi.

Gagal menambahkan layanan atau menginstal

1. Lingkungan npx tidak ditemukan

Pesan Kesalahan: Gagal memulai perintah: exec: "npx": file yang dapat dieksekusi tidak ditemukan di $PATH
Solusi: Unduh dan instal Node.js versi 18 atau lebih tinggi dari Node.js, atau ikuti langkah-langkah berikut:

Peringatan

Versi Node.js harus v18 atau lebih tinggi, dan versi npm harus v8 atau lebih tinggi. Versi yang lebih rendah dapat menyebabkan kegagalan pemanggilan alat.

Langkah-Langkah

1. Unduh dan instal Node.js.

Windows

Instal nvm-windows untuk mengelola beberapa versi:

nvm install 22.14.0  # Instal versi yang ditentukan
nvm use 22.14.0

Verifikasi instalasi.
```
node -v
npx -v
```
Terminal akan menampilkan nomor versi Node.js yang terinstal.

macOS

Instal Node.js menggunakan Homebrew (memerlukan Homebrew).

# 1. Perbarui Homebrew dan instal Node.js<p># 1. Perbarui Homebrew dan instal Node.js</p>
brew update
brew install node

# 2. Verifikasi instalasi dan konfirmasikan versi
echo "Versi Node.js: $(node -v)"
echo "Versi npm: $(npm -v)"
echo "Versi npx: $(npx -v)"

# 3. Konfigurasikan variabel lingkungan (jika perlu)
echo 'export PATH="/usr/local/opt/node@16/bin:$PATH"' >> ~/.zshrc

2. Lingkungan uvx tidak ditemukan

Pesan Kesalahan: Gagal memulai perintah: exec: "uvx": file yang dapat dieksekusi tidak ditemukan di $PATH
Solusi: Instal uv. uvx adalah alat pendamping untuk uv untuk menjalankan skrip Python dalam lingkungan terisolasi.

Langkah-Langkah

1. Unduh dan instal uv.

Windows

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

macOS dan Linux

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

2. Setelah instalasi, jalankan perintah berikut di terminal untuk memverifikasi instalasi:

uv --version

3. Terminal akan menampilkan nomor versi uv yang terinstal.

3. Tidak dapat menginisialisasi Klien MCP

Pesan Kesalahan: Gagal menginisialisasi klien MCP: batas waktu konteks terlampaui
Kemungkinan Penyebab:
- Parameter layanan MCP mungkin memiliki kesalahan yang memengaruhi inisialisasi layanan.
- Kegagalan penarikan sumber daya karena koneksi jaringan.
- Pembatasan keamanan jaringan dari perusahaan Anda mungkin memblokir inisialisasi layanan MCP.

Langkah-Langkah Pemecahan Masalah:

1. Klik copy complete command.

莫3@1x (64)

2. Jalankan perintah di terminal untuk mendapatkan detail kesalahan.

莫3@1x (67)

3. Analisis kesalahan dan perbaiki.

Masalah Umum 1: Kesalahan Konfigurasi

Pesan kesalahan menunjukkan bahwa kegagalan koneksi disebabkan oleh konfigurasi URL koneksi Redis yang salah. Periksa dan edit layanan MCP untuk memperbaiki konfigurasi URL.

Masalah Umum 2: Kegagalan Penarikan Sumber Daya

Jika perintah gagal dijalankan karena masalah penarikan sumber daya, jalankan perintah berikut di baris perintah untuk menambahkan sumber cermin, lalu mulai ulang proses Lingma dan coba lagi.

Windows

npm config set registry https://registry.npmmirror.com

macOS

export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/

Masalah Umum 3: Eksekusi Node.js Diblokir oleh Komponen Keamanan

Otorisasi atau daftarkan proses Node.js atau file terkait sesuai dengan pesan.

Masalah terkait penggunaan alat

Catatan

Jika Anda memiliki pertanyaan tentang layanan MCP yang disediakan oleh ModelScope, hubungi Grup Pengembang ModelScope melalui nomor grup DingTalk: 44837352.

1. Gagal mengeksekusi alat karena kesalahan variabel lingkungan atau input parameter.

Langkah-langkah pemecahan masalah:

Jika ada pengecualian atau hasil tak terduga saat memanggil alat MCP, periksa pesan kesalahan terlebih dahulu di bilah alat dan analisis serta pecahkan masalah sesuai dengan itu.

Penting

Beberapa layanan MCP (seperti Mastergo dan Figma) mencakup API_KEY atau TOKEN dalam argumen. Parameter ini masih perlu dikonfigurasi secara manual saat instalasi.

莫3@1x (62)

Solusi:

Buka halaman Settings di plugin IDE.
Temukan layanan MCP yang sesuai dan klik Edit.
Di halaman Edit MCP Service, periksa parameter di Argumen.
Ganti Argumen dengan yang benar, sambungkan ulang layanan dan coba panggil lagi.

莫3@1x (68)

2. LLM tidak dapat memanggil alat MCP.

Pastikan Anda berada dalam Agent mode.
Penting
Jika tidak ada direktori proyek yang dibuka, sistem hanya akan masuk ke mode Tanya dan tidak dapat memanggil alat MCP. Muat direktori proyek yang sesuai dan beralihlah ke mode Agent.
Konfirmasikan bahwa layanan MCP berada dalam status tersambung:
- Jika koneksi layanan terputus, klik di sisi kanan antarmuka, dan sistem akan secara otomatis mencoba memulai ulang layanan MCP.
Saran Penggunaan: Hindari menggunakan penamaan serupa untuk layanan MCP dan alat mereka (seperti TextAnalyzer-Pro dan TextAnalyzer-Plus keduanya berisi alat bernama fetchText dengan fungsi serupa), untuk mencegah ambiguitas saat memanggil layanan MCP.

3. Tidak dapat membuka halaman alat MCP di Pengaturan, dan halaman menampilkan kosong.

Halaman menampilkan kosong dan ada pesan kesalahan di idea.log seperti: "WARN - #c.i.u.j.JBCefApp - JCefAppConfig.class bukan dari modul JBR".

Penyebab: Pengaturan default Android Studio tidak mendukung JCEF, menyebabkan pengaturan pribadi, MCP, dan halaman lainnya gagal dimuat.

Solusi:

Konfigurasikan JCEF: Di IDE, pilih Help > Find Action.., dan di kotak input popup, ketik Registry dan buka.
- Aktifkan opsi ide.browser.jcef.enabled.
- Nonaktifkan opsi ide.browser.jcef.sandbox.enable.
Konfigurasikan Runtime IDE: Pilih Help > Find Action.., ketik Pilih Boot Runtime untuk IDE di kotak obrolan dan buka. Pilih versi JCEF Runtime yang lebih baru, lalu konfirmasi.
Mulai ulang IDE.

4. Daftar layanan MCP tidak dapat dimuat

Daftar layanan terus menampilkan sedang memuat.

Mulai ulang IDE.
Jika masalah tetap ada, coba mulai layanan Lingma secara manual:
Windows
Pergi ke direktori: .lingma/bin/x.x.x/Arsitektur_CPU_64_sistem/
Jalankan perintah:
```
Lingma.exe start
```
macOS
1. Klik ikon Apple di pojok kiri atas komputer, pilih About This Mac untuk memeriksa model prosesor, lalu pergi ke direktori yang sesuai:
  1. chip m1: /.lingma/bin/x.x.x/aarch64_darwin/Lingma
  2. chip intel: /.lingma/bin/x.x.x/x86_64_darwin/Lingma
2. Jalankan perintah ini:
```
Lingma start
```
Setelah startup, klik tombol login untuk mencoba lagi.