aka-ao's blog

CursorでのMCP設定時のエラー対処法

AIMCPCursorトラブルシューティング

Model Context Protocol (MCP)をCursorで設定する際に発生する問題と解決方法

はじめに

Model Context Protocol (MCP)をCursorで設定する際に、様々なエラーが発生することがあります。この記事では、よくあるエラーとその解決方法について解説します。

よくあるエラー

npxパスエラー

Cursorで以下のようなエラーが発生することがあります：

2025-02-28T07:15:23.100Z [github] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}

または：

Failed to connect to stdio server with command 'npx -y @smithery/cli@latest run @smithery-ai/server-sequential-thinking --config "{}"': A system error occurred (spawn npx ENOENT)

これらのエラーは、主にnpxコマンドのパスが正しく解決されないことが原因で発生します。

解決方法

1. npxの絶対パスを使用する

ターミナルで which npx コマンドを実行して、npxの絶対パスを取得します。そして、取得したパスをCursorのMCP設定のコマンドフィールドに指定します。

例：

/home/username/.nvm/versions/node/v20.11.0/bin/npx -y @modelcontextprotocol/server-sequential-thinking

これにより、Cursorがnpxコマンドを見つけられない問題を解決できます。特に、Node.jsのバージョン管理ツール（nvmなど）を使用している場合に効果的です。

2. パスにスペースがないことを確認する

MCPサーバーをインストールするパスにスペースが含まれていると、コマンドが正しく解析されない場合があります。パスにスペースが含まれていないことを確認してください。

例えば、以下のようなパスはエラーの原因になる可能性があります：

C:/my projects/mcpserver/build/index.js

代わりに、以下のようなスペースを含まないパスを使用してください：

C:/projects/mcpserver/build/index.js

3. シェルスクリプトを使用する

複雑な設定や環境変数が必要な場合は、シェルスクリプト（.shファイル）を作成し、その中でMCPサーバーを起動するコマンドを記述することができます。そして、Cursorの設定でそのシェルスクリプトのパスを指定します。

例（Linux/Mac）：

#!/bin/bash
TARGET_DIR=/path/to/mcp-server
cd "${TARGET_DIR}"
export PYTHONIOENCODING=utf-8
npx -y @smithery/cli@latest run @smithery-ai/puppeteer --config "{}"

このスクリプトを実行可能にして（chmod +x script.sh）、Cursorの設定で以下のように指定します：

/path/to/script.sh

4. グローバルにインストールする

MCPサーバーをグローバルにインストールすることで、パスの問題を回避できる場合があります：

npm install -g @modelcontextprotocol/server-sequential-thinking

そして、Cursorの設定で以下のように指定します：

node /path/to/global/node_modules/@modelcontextprotocol/server-sequential-thinking/build/index.js

グローバルインストールのパスは、npm root -gコマンドで確認できます。

その他のトラブルシューティング

サーバーが起動しない場合

  1. 依存関係の確認: 必要なパッケージがすべてインストールされているか確認します。
  2. ファイアウォールの設定: ファイアウォールがMCPサーバーの通信をブロックしていないか確認します。
  3. ポートの競合: 他のアプリケーションが同じポートを使用していないか確認します。

ツールが表示されない場合

  1. サーバーの再起動: MCPサーバーを再起動してみてください。
  2. Cursorの再起動: Cursorを完全に再起動してみてください。
  3. ログの確認: ~/.cursor/logs/mcp.logでエラーログを確認してください。

まとめ

MCPの設定時に問題が発生した場合は、上記の解決方法を試してみてください。特に、npxの絶対パスを使用する方法は、多くの場合に効果的です。

これらの方法でも問題が解決しない場合は、Cursor公式フォーラムで質問するか、MCP公式ドキュメントを参照してください。