Implements the MCP server as an Electron application, providing a GUI interface for monitoring and controlling the server state across Windows, macOS, and Linux platforms.
Electron MCP Server 🚀
ElectronでModel Context Protocol (MCP) サーバを実装したアプリケーション
ElectronアプリケーションとしてMCPサーバを起動し、Claude DesktopなどのAIアプリケーションから簡単に利用できるようにします。npxやNode.jsのインストールが不要で、エンジニアでない方でも簡単に使用できます。
特徴
- ✅ 簡単起動: Electronアプリとして起動するだけでMCPサーバが開始
- ✅ Streamable HTTP対応: 最新のMCP仕様に準拠
- ✅ GUI管理: サーバー状態の監視と制御が可能
- ✅ クロスプラットフォーム: Windows、macOS、Linuxで動作
- ✅ npx不要: 実行ファイルとして配布可能
クイックスタート
開発環境での実行
- 依存関係のインストール
- アプリケーションの起動
- 開発モードで起動(DevToolsが開きます)
アプリケーションが起動すると、自動的にポート3999でMCPサーバが開始されます。
MCPエンドポイント
- メインエンドポイント:
http://localhost:3999/mcp
- ヘルスチェック:
http://localhost:3999/health
Claude Desktopでの設定
Claude Desktopの設定ファイル(claude_desktop_config.json
)に以下を追加:
利用可能なツール
1. ping
サーバーの応答確認用ツール
2. echo
メッセージをそのまま返すツール
3. get_server_info
サーバー情報を取得するツール
API使用例
ツール一覧の取得
pingツールの実行
ビルドと配布
実行ファイルの作成
ローカルでのビルド
環境変数を設定してビルド:
または.envファイルを使用:
GitHub Actionsでの自動ビルド
- リポジトリのSettings → Secrets and variables → Actions
ELECTRON_GITHUB_TOKEN
をRepository Secretとして追加- タグをpushまたはworkflow_dispatchで自動ビルド
ビルドされたファイルはdist/
フォルダに出力されます。
⚠️ セキュリティ注意:
.env
ファイルは絶対にリポジトリにコミットしないでください。
開発
プロジェクト構造
カスタムツールの追加
src/mcp-server.js
のsetupMCPHandlers()
メソッドで新しいツールを追加できます:
トラブルシューティング
ポート3999が使用中の場合
環境変数MCP_PORT
でポートを変更できます:
WSL環境でのDBusエラー
WSL環境では以下のエラーが表示される場合がありますが、アプリケーションの動作には影響しません:
ライセンス
MIT License
技術スタック
- Electron: ^28.0.0
- Express: ^4.18.2
- @modelcontextprotocol/sdk: ^0.5.0
- CORS: ^2.8.5
貢献
Issues、Pull Requestを歓迎します。
リンク
This server cannot be installed
A cross-platform desktop application that runs a Model Context Protocol server, allowing AI applications like Claude Desktop to easily connect without requiring npx or Node.js installation.
Related MCP Servers
- AsecurityAlicenseAqualityModel Context Protocol server that enables Claude Desktop (or any MCP client) to fetch web content and process images appropriately.Last updated -138MIT License
302AI BrowserUse MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol server that enables Claude Desktop to browse the web, likely allowing the AI to access and interact with web content.Last updated -275MIT LicenseGladia MCPofficial
-securityAlicense-qualityOfficial Model Context Protocol server that enables interaction with powerful Speech-to-Text and Audio Intelligence APIs, allowing clients like Claude Desktop to transcribe audio, analyze speech, translate content, and more.Last updated -2MIT License