Cursor MCP Servers 0.46 Windows 配置指南 について
Windows の Cursor IDE 0.46 以降で MCP サーバーを設定するためのガイドです。設定画面と JSON の方法を扱い、一部の内容が不正確な可能性やプロジェクト単位の設定が動作しない場合があることも記しています。
主な機能
- 01Cursor の設定画面から MCP サーバーを追加
- 02プロジェクト用・全体用 mcp.json の設定
- 03サーバーの環境変数設定
- 04接続や権限の問題の調査
活用シーン
- 01Windows の Cursor で MCP を設定
- 02サーバーの未表示や状態異常を調査
- 03プロジェクトごとにサーバー設定を変更
MCP 対応
Cursor で MCP サーバーを設定し、AI アシスタントから外部ツールを利用する方法を説明します。検索、ウェブ閲覧、ファイルシステムなどのサーバー例を挙げています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
1掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| thought | string | はい | 現在の思考ステップ |
| nextThoughtNeeded | boolean | いいえ | 次の思考ステップが必要かどうか |
| thoughtNumber | integer | はい | 現在の思考番号(数値、例:1、2、3) |
| totalThoughts | integer | はい | 必要な思考の推定合計数(数値、例:5、10) |
| isRevision | boolean | いいえ | 以前の思考を修正するかどうか |
| revisesThought | integer | いいえ | 再検討する思考の番号 |
| branchFromThought | integer | いいえ | 分岐元となる思考の番号 |
| branchId | string | いいえ | 分岐の識別子 |
| needsMoreThoughts | boolean | いいえ | さらに思考が必要かどうか |
詳細
Cursor MCP Servers 0.46 Windows 設定ガイド
これはすべてCursor内で行っています。リポジトリの作成からファイルの生成、READMEの設定一式、リポジトリへのアップロードと更新まで、すべてCursor内で自然言語を使って実現しています。これはすべてCursor内で行っています。リポジトリの作成からファイルの生成、READMEの設定一式、リポジトリへのアップロードと更新まで、すべてCursor内で自然言語を使って実現しています。 (リポジトリ内には問題がある内容が含まれている可能性があるため、100%信用しないでください) これはすべてCursorで行っています。リポジトリの作成からファイルの生成、READMEの設定一式、リポジトリのアップロードと更新まで、すべてCursor内で自然言語を使って実現しています。 (リポジトリ内には問題がある内容が含まれている可能性があるため、100%信用しないでください)
概要
このリポジトリでは、Windows環境でCursor IDE 0.46に搭載されたMCP(Model Context Protocol)Servers機能を設定して使用するための詳しいガイドを提供します。MCPを使うと、AI アシスタントが外部のツールやサービスを利用できるようになり、機能と実用性が大幅に向上します。
MCPとは?
MCP(Model Context Protocol)は、LLM(大規模言語モデル)が外部のツールやサービスとやり取りできるようにするプロトコルです。Cursor IDEのMCP Servers機能を使うと、AI アシスタントはさまざまなツールを呼び出して、検索、ウェブ閲覧、コード実行などを行えます。
目次
前提条件
MCP Serversの設定を始める前に、以下の条件を満たしていることを確認してください。
- Cursor IDE 0.46以降
- Windows 10/11オペレーティングシステム
- Node.js v18以降
- 基本的なコマンドラインの知識
- 特定のMCPサーバーで必要となるAPIキー
インストール方法
方法1:Cursorの設定画面から設定する
初心者に適した最も簡単な方法です。
- Cursor IDEを開きます
- 左下にある設定アイコン(⚙️)をクリックします
- 「Features」セクションに移動します
- 「MCP Servers」セクションまでスクロールします
- 「Add New MCP Server」をクリックします
- 接続タイプとして「Stdio/local」を選択します
- サーバーコマンドを入力します(よく使われるMCPサーバーのセクションを参照)
- 「Add」をクリックして設定を保存します
方法2:プロジェクト単位の設定ファイルを使う
注意:Windows環境では、プロジェクト単位の設定ファイル機能がCursor 0.46で正しく動作しない場合があります。この方法が機能しない場合は、方法1または方法3を使用してください。
特定のプロジェクト用にMCPサーバーを設定します。
- プロジェクトのルートディレクトリに
.cursorフォルダーを作成します(存在しない場合) .cursorフォルダー内にmcp.jsonファイルを作成します- 以下の形式でMCPサーバーを設定します。
{
"mcpServers": {
"server_name": {
"command": "command_executable",
"args": ["arg1", "arg2", "..."]
}
}
}
たとえば、Sequential Thinkingサーバーを設定する場合:
{
"mcpServers": {
"sequential_thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
}
方法3:グローバル設定ファイルを使う
注意:グローバル設定ファイル機能を利用するには、特定のバージョンのCursorが必要な場合があります。
すべてのプロジェクト用にMCPサーバーを設定します。
- Cursorの設定ディレクトリに移動します(通常は
%APPDATA%\Cursorです) mcp.jsonファイルを作成または編集します- プロジェクト単位の設定と同じ形式を使用します
よく使われるMCPサーバー
以下は、よく使われるMCPサーバーとその設定コマンドです。
Sequential Thinking
npx -y @modelcontextprotocol/server-sequential-thinking
Brave Search
env BRAVE_API_KEY=[your-key] npx -y @modelcontextprotocol/server-brave-search
Puppeteer(ウェブ閲覧)
npx -y @modelcontextprotocol/server-puppeteer
GitHubツール
npx -y @modelcontextprotocol/server-github
ファイルシステムツール
npx -y @modelcontextprotocol/server-fs
環境変数の設定
一部のMCPサーバーでは、APIキーやその他の設定に環境変数が必要です。Windowsで環境変数を設定する方法はいくつかあります。
方法1:コマンド内で直接設定する
env API_KEY=your_key_here npx -y @package/server-name
方法2:PowerShellで一時的な環境変数を設定する
$env:API_KEY="your_key_here"
npx -y @package/server-name
方法3:システム環境変数を使う
- 「PC」を右クリックし、「プロパティ」を選択します
- 「システムの詳細設定」をクリックします
- 「環境変数」をクリックします
- 「ユーザー環境変数」セクションで新しい変数を追加します
トラブルシューティング
よくある問題と解決策
-
MCPサーバーの状態が黄色で表示される
- サーバーの状態を更新してみてください
- コマンドが正しいか確認してください
- Cursor IDEを再起動してください
-
MCPツールが見つからない
- ComposerモードまたはAgentモードで使用していることを確認してください
- MCPツールを使うようAIに明示的に指示してください
- サーバーの状態が緑色であることを確認してください
-
Windowsの権限に関する問題
- ターミナルを管理者として実行してみてください
- ファイアウォールの設定を確認してください
- Node.jsに十分な権限があることを確認してください
-
プロジェクト単位の設定ファイルが機能しない
- これはWindows環境で確認されている問題です
- グローバル設定ファイルを使うか、設定画面から追加してみてください
-
Node.jsのバージョンに関する問題
nvmを使ってNode.js v18以降に切り替えます。
nvm install 18 nvm use 18
ベストプラクティス
-
必要なサーバーだけを追加する
- 現在のタスクで必要なMCPサーバーだけを追加してください
- サーバーを追加しすぎると、トークンの消費量が増える可能性があります
-
CMDの代わりにGit Bashを使う
- Windowsユーザーは、一部のMCPサーバーの実行にCMDよりGit Bashのほうが適していると感じる場合があります
-
APIキーを安全に保存する
- 共有コードにAPIキーをハードコードしないでください
- 環境変数または安全なキー管理ソリューションを使用してください
-
MCPサーバーを定期的に更新する
- MCPエコシステムは急速に発展しているため、定期的に更新を確認してください
-
プロジェクト固有の設定
- プロジェクトごとに異なるMCPサーバー設定を使用してください
- プロジェクト単位の設定ファイルの使用を検討してください(サポートされている場合)
よくある質問
MCPは特定のモードでのみ動作しますか?
はい。MCPツールはComposerモードとAgentモードでのみ利用できます。
MCPサーバーが正常に動作しているかどうかは、どうすれば分かりますか?
サーバーの状態インジケーターが緑色で表示され、使用時にターミナルウィンドウがポップアップします。
MCPサーバーはいくつまで同時に使用できますか?
理論上は制限はありませんが、リソースの消費を抑えるため、必要なサーバーだけを追加することをおすすめします。
複数のコンピューター間でMCP設定を共有するにはどうすればよいですか?
.cursor/mcp.jsonファイルをバージョン管理システムに追加するか、設定同期ツールを使用できます。
参考資料
貢献
改善や更新のための貢献を、IssuesやPull Requestsを通じて歓迎します。
ライセンス
MIT License - 詳細はLICENSEファイルを参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。