local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides Google Drive integration for file management, allowing the MCP server to interact with Google Drive for storing and retrieving files.

カーソル用MCPサーバー

Cursor IDE 統合用のモデルコンテキストプロトコル (MCP) サーバー実装。SSE (Server-Sent Events) および WebSocket 接続を通じて最新の Web ダッシュボードとツールを提供します。

特徴

WebSocketサポートによるリアルタイム接続監視
サーバー管理用の最新のWebダッシュボード
カーソル IDE との SSE ベースの通信
接続性を検証するための内蔵テストツール
ファイル管理のためのGoogleドライブ統合
新しいツールを追加するための拡張可能なアーキテクチャ
接続履歴の可視化
クライアント管理インターフェース
サービス構成UI
カスタマイズ可能なサーバー設定

前提条件

Python 3.8以上
Node.js 18以上
npm (Node.js パッケージマネージャー)
pip (Python パッケージマネージャー)
カーソルIDE

インストール

リポジトリをクローンします。

git clone <repository-url>
cd MCP-Server

依存関係をインストールします:

# Install all dependencies (both backend and frontend)
npm run install-all

# Or install separately:
# Backend dependencies
pip install -r requirements.txt

# Frontend dependencies
cd frontend
npm install
cd ..

発達

開発サーバーを起動します。

# Start both backend and frontend in development mode
npm run dev   # This will start both servers concurrently

サーバーは次の場所から開始されます:

バックエンド: http://localhost:8765
フロントエンド: http://localhost:3000 (ポート 3000 が使用されている場合は3001 )

サーバーを個別に起動することもできます。

# Backend (in one terminal)
python mcp_server.py

# Frontend (in another terminal)
cd frontend
npm run dev

開発サーバーは以下を提供します。

フロントエンドの変更に対するホットリロード
バックエンドへの API リクエストの自動プロキシ
WebSocket接続処理
バックエンドとフロントエンドの同時開発

ポート3000を使用する他のアプリケーションを実行している場合、フロントエンドは自動的にポート3001を試行し、利用可能なポートが見つかるまでポート番号を増やしていきます。実際のURLはnpm run dev実行するとターミナルに表示されます。

プロジェクト構造

MCP-Server/
├── frontend/                # Frontend application
│   ├── src/                # Source code
│   │   ├── api/           # API clients
│   │   ├── pages/         # React components
│   │   └── main.tsx       # Entry point
│   ├── package.json       # Frontend dependencies
│   └── vite.config.ts     # Vite configuration
├── mcp_server.py          # Main server implementation
├── services.py            # Service management
├── test_client.py         # Test client implementation
├── requirements.txt       # Python dependencies
├── package.json           # Root package.json
└── services_config.json   # Service configurations

利用可能なエンドポイント

HTTPエンドポイント

/api/status - サーバーのステータスを取得する
/api/connections/history - 接続履歴を取得する
/api/clients - アクティブなクライアントを取得する
/api/services/{service_id} - サービス構成
/api/settings - サーバー設定

WebSocketエンドポイント

/ws/{client_id} - リアルタイム更新とping/pong

SSEエンドポイント

/sse - カーソル IDE のサーバー送信イベント

ツールエンドポイント

/invoke/test - テストツール
/invoke/google_drive - Google ドライブの操作

本番環境への展開

本番サーバーをビルドして起動します。

# Build frontend and start production server
npm run prod

# Or build frontend separately:
npm run build
python mcp_server.py

構成

初期設定

テンプレート構成をコピーします。

cp services_config.template.json services_config.json

サービス資格情報を使用してservices_config.jsonを更新します。
- Google ドライブの場合:
  - Google Cloud Console でプロジェクトを作成する
  - GoogleドライブAPIを有効にする
  - OAuth 2.0認証情報を作成する
  - client_idとclient_secretを追加します

サーバー設定

Web ダッシュボードからサーバー設定を構成します。

デバッグモード
SSL設定
接続制限
Pingタイムアウト
プロトコル設定

テスト

提供されているテストクライアントを使用してサーバーをテストします。

python test_client.py

テストクライアントは次のことを実行します。

SSEとWebSocketエンドポイントの両方に接続する
定期的にpingを送信する
利用可能なツールをテストする
接続ステータスを監視する

トラブルシューティング

接続の問題
- バックエンドとフロントエンドの両方のログを確認する
- ブラウザのDevToolsでWebSocket接続を確認する
- vite.config.tsのプロキシ設定が正しいことを確認します
- ポートの競合を確認する
フロントエンドの問題
- ブラウザのキャッシュをクリアする
- ブラウザコンソールでエラーを確認する
- Node.jsとnpmのバージョンを確認する
- TypeScriptのコンパイルエラーを確認する
バックエンドの問題
- mcp_server.logでエラーを確認してください
- Pythonの依存関係がインストールされていることを確認する
- ポートの空き状況を確認する
- サービス構成が有効であることを確認する

セキュリティノート

サーバーは開発中のすべてのオリジン（CORS * ）を受け入れます
WebSocket接続では基本的な識別にクライアントIDを使用する
サービス資格情報はservices_config.jsonに保存されます。
本番環境では機密データに環境変数を使用する必要があります

貢献

リポジトリをフォークする
機能ブランチを作成する
変更を加える
テストを実行する
プルリクエストを送信する

ライセンス

[ここにライセンス情報を追加してください]

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Cursor IDE と統合され、SSE および WebSocket 接続を介してリアルタイム通信、最新の Web ダッシュボード、拡張可能なツールを提供するモデルコンテキストプロトコルサーバーです。

Related Resources

Reddit Discussion about this server

MCP Server for Cursor