すべてのプロダクト
Search

このプロダクト

    AI Coding Assistant Lingma:MCP に関するよくある質問

    ドキュメントセンター

    AI Coding Assistant Lingma:MCP に関するよくある質問

    最終更新日:Jun 09, 2025

    MCP サーバーのインストールおよび操作中の例外のトラブルシューティングを行い、不足している環境、サービスの初期化の失敗、および構成エラーの処理方法の詳細について学習します。

    サービスの追加またはインストールに失敗しました

    1. npx 環境がありません

    • エラーメッセージ: failed to start command: exec: "npx": executable file not found in $PATH

    • 解決策: Node.js にアクセスして Node.js 18 以上をダウンロードしてインストールするか、以下の手順に従います。

    警告

    Node.js のバージョンは v18 以上、npm のバージョンはバージョン 8 以上である必要があります。低いバージョンでは、ツールの呼び出しが失敗する可能性があります。

    手順

    1. Node.js をダウンロードしてインストールします。

    Windows

    1. nvm-windows をインストールして複数のバージョンを管理します。

      nvm install 22.14.0  # 指定されたバージョンをインストールする
nvm use 22.14.0

    2. インストールを確認します。

      node -v
npx -v

    3. 端末にインストールされている Node.js のバージョン番号が表示されます。

    macOS

    Homebrew で Node.js をインストールします（最初に Homebrew をインストールする 必要があります）。

    # 1. Homebrew を更新し、Node.js をインストールする
brew update
brew install node

# 2. インストールを確認し、バージョンを確認する
echo "Node.js version: $(node -v)"
echo "npm version: $(npm -v)"
echo "npx version: $(npx -v)"

# 3. 環境変数を構成する（必要な場合）
echo 'export PATH="/usr/local/opt/node@16/bin:$PATH"' >> ~/.zshrc

    2. uvx 環境がありません

    • エラーメッセージ: failed to start command: exec: "uvx": executable file not found in $PATH

    • 解決策: uv をインストールします。uvx は、分離された環境で Python スクリプトを実行するための uv のコンパニオンツールです。

    手順

    1. uv をダウンロードしてインストールします。

    Windows

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

    macOS および Linux

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

    2. インストール後、端末で次のコマンドを実行して、インストールが成功したことを確認します。

    uv --version

    3. 端末にインストールされている uv のバージョン番号が表示されます。

    3. MCP Client を初期化できません

    • エラーメッセージ: failed to initialize MCP client: context deadline exceeded

    • 考えられる原因:

      • MCP サービスパラメーターにエラーがあり、サービスの初期化に影響を与えている可能性があります。

      • ネットワーク接続が原因でリソースのプルに失敗した可能性があります。

      • 会社のネットワークセキュリティ制限により、MCP サービスの初期化がブロックされている可能性があります。

    • トラブルシューティング手順:

      1. [コマンド全体をコピー] をクリックします。

      莫3@1x (64)

      2. 端末でコマンドを実行して、エラーの詳細を取得します。

      莫3@1x (67)

      3. エラーを分析して修正します。

      一般的な問題 1: 構成エラー

      上記の例では、エラーメッセージは、Redis 接続 URL の構成が正しくないことが原因で接続に失敗したことを示しています。MCP サービスを確認および編集して、URL の構成を修正します。

      一般的な問題 2: リソースのプルに失敗しました

      リソースのプルの問題が原因でコマンドの実行に失敗した場合は、コマンドラインで次のコマンドを実行してミラーソースを追加してから、Lingma プロセスを再起動して、再試行します。

      Windows

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

      macOS

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

      一般的な問題 3: セキュリティコンポーネントによって Node.js の実行がブロックされています

      メッセージに従って、Node.js プロセスまたは関連ファイルの承認またはホワイトリスト登録を行います。

    ツールの使用に関する問題

    説明

    ModelScope が提供する MCP サービスについてご不明な点がある場合は、DingTalk グループ番号 44837352 で ModelScope 開発者グループにお問い合わせください。

    1. 環境変数またはパラメーターの入力エラーが原因でツールを実行できませんでした。

    • トラブルシューティング手順:

    MCP ツールを呼び出すときに例外または予期しない結果が表示された場合は、最初にツールバーのエラーメッセージを確認し、それに応じて分析およびトラブルシューティングを行います。

    重要

    一部の MCP サービス (Mastergo や Figma など) では、引数に API_KEY または TOKEN が含まれています。これらのパラメーターは、インストール時に手動で構成する必要があります。

    莫3@1x (62)

    • 解決策:

    1. IDE プラグインの [設定] ページに移動します。

    2. 例: 投稿タイトルを表示する

    3. [MCP サービスの編集] ページで、引数のパラメーターを確認します。

    4. 引数を正しい引数に置き換え、サービスを再接続して、もう一度呼び出してみてください。

    莫3@1x (68)

    2. LLM は MCP ツールを呼び出すことができません。

    1. エージェント モードであることを確認します。

      重要

      プロジェクトディレクトリが開かれていない場合、システムは質問モードのみに入り、MCP ツールを呼び出すことができません。対応するプロジェクトディレクトリを読み込んで、エージェントモードに切り替えます。

    2. MCP サービスが接続状態であることを確認します。

      • サービス接続が切断された場合は、インターフェイスの右側にある image をクリックすると、システムは自動的に MCP サービスの再起動を試みます。 莫3@1x (66)

    3. 使用方法の提案: MCP サービスとそのツールに類似した名前を使用しないようにしてください (TextAnalyzer-Pro と TextAnalyzer-Plus の両方に、同様の機能を持つ fetchText という名前のツールが含まれているなど)。これにより、MCP サービスを呼び出す際のあいまいさを防ぐことができます。

    3. [設定] で MCP ツールページを開くことができず、ページが空白で表示されます。

    ページが空白で表示され、idea.log に「WARN - #c.i.u.j.JBCefApp - JCefAppConfig.class is not from a JBR module」のようなエラーメッセージが表示されます。

    原因: Android Studio のデフォルト設定では JCEF がサポートされていないため、個人設定、MCP、その他のページが読み込まれません。

    解決策:

    1. JCEF を構成します。IDE で、[ヘルプ] > [アクションを検索..] を選択し、ポップアップ入力ボックスに「Registry」と入力して開きます。

      • ide.browser.jcef.enabled オプションを有効にします。

      • ide.browser.jcef.sandbox.enable オプションを無効にします。

      莫3@1x (70)

    2. IDE ランタイムを構成します。[ヘルプ] > [アクションを検索..] を選択し、チャットボックスに「Choose Boot Runtime for the IDE」と入力して開きます。新しい JCEF ランタイムバージョンを選択して、確認します。 莫3@1x (72)

    3. IDE を再起動します。

    4. MCP サービスリストを読み込めません

    サービスリストに読み込み中と表示され続けます。

    1. IDE を再起動します。

    2. 問題が解決しない場合は、Lingma サービスを手動で起動してみてください。

      Windows

      ディレクトリ .lingma/bin/x.x.x/CPU architecture_64_system/ に移動します

      コマンドを実行します。

      Lingma.exe start

      macOS

      1. コンピューターの左上隅にある Apple アイコンをクリックし、[この Mac について] を選択してプロセッサモデルを確認してから、対応するディレクトリに移動します。

        1. m1 チップ: /.lingma/bin/x.x.x/aarch64_darwin/Lingma

        2. intel チップ: /.lingma/bin/x.x.x/x86_64_darwin/Lingma

      2. 次のコマンドを実行します。

      Lingma start

    3. 起動後、ログインボタンをクリックして再試行します。