Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Universal MCP Serverread the project notes from file:///meeting_minutes.txt"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Universal MCP Server
OpenAIとClaude両対応のModel Context Protocolサーバー実装
特徴
✅ マルチモード対応
STDIOモード: Claude Desktop統合
HTTPモード: OpenAI、ngrok、外部アクセス対応
✅ OpenAI & Claude 完全対応
✅ ファイルの読み込み・書き込み・削除・検索機能
✅ MCP仕様に厳密に準拠（SDK v1.18.1）
✅ SSE (Server-Sent Events) サポート
✅ APIキー認証（オプション）
✅ CORS対応
✅ 包括的なロギング（Winston使用）
✅ 非同期書き込み制御（ロック機構）
✅ TypeScript完全型安全
✅ モジュール化された設計
プロジェクト構造
universal-mcp-server/
├── src/
│ ├── index.ts # メインサーバー実装（STDIOモード）
│ ├── index-multimode.ts # マルチモード対応版
│ ├── http-server.ts # HTTP/SSEサーバー実装
│ ├── logger.ts # ロギングモジュール
│ └── storage.ts # ストレージモジュール
├── build/ # ビルド出力
├── data/ # データストレージ
├── logs/ # ログファイル
├── .env.example # 環境設定例
├── NGROK.md # ngrok設定ガイド
├── OPENAI.md # OpenAI統合ガイド
├── package.json
├── tsconfig.json
└── README.mdインストール
npm install
npm run buildクイックスタート
詳細は QUICKSTART.md を参照してください。
Claude Desktop（STDIOモード）
npm startOpenAI / Web統合（HTTPモード）
# 認証なし（開発用）
MCP_MODE=http npm run dev:http
# 認証あり（推奨）
export MCP_API_KEY=$(openssl rand -hex 32)
./start-http.shngrokで外部公開
最も簡単な方法（オールインワン）
# MCPサーバー + ngrokを同時起動
./start-all.sh個別起動
# ターミナル1: MCPサーバー
./start-http.sh
# ターミナル2: ngrok
./start-ngrok.sh手動起動
ngrok http 3000使用方法
STDIOモード（Claude Desktop用）
# 開発モード
npm run dev
# 本番実行
npm startHTTPモード（OpenAI、ngrok対応）
# 開発モード（認証なし）
MCP_MODE=http npm run dev:http
# 本番実行（認証なし）- 開発用のみ
MCP_MODE=http npm start:http
# 本番実行（認証あり）- 推奨
MCP_MODE=http MCP_HTTP_PORT=3000 MCP_API_KEY=your-secret-key npm start:http:auth環境変数設定
# .envファイルを作成
cp .env.example .env
# .envファイルを編集
# MCP_MODE=http
# MCP_HTTP_PORT=3000
# MCP_HTTP_HOST=0.0.0.0
# MCP_API_KEY=your-secret-api-keyngrokでの外部公開
# 別のターミナルでngrokを起動
ngrok http 3000詳細は NGROK.md を参照してください。
OpenAIとの統合
詳細は OPENAI.md を参照してください。
デバッグ・インスペクター
npm run inspectClaude Desktopでの設定
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"universal-mcp": {
"command": "node",
"args": ["/path/to/universal-mcp-server/build/index.js"]
}
}
}HTTPモードのエンドポイント
エンドポイント | メソッド | 説明 | 認証 |
| GET | ヘルスチェック | 不要 |
| GET | サーバー情報 | 必要* |
| GET | SSE接続（MCP通信） | 必要* |
| POST | メッセージ送信 | 必要* |
*APIキーが設定されている場合のみ
認証ヘッダー
curl -H "Authorization: Bearer your-api-key" \
http://localhost:3000/info停止方法
# すべてのプロセスを停止
./stop-all.sh
# ngrokのみ停止
./stop-ngrok.sh
# または個別に停止
pkill -f "node build/index"
pkill -f "ngrok"トラブルシューティング
プロセスが停止できない、ポートが専有されているなどの問題は TROUBLESHOOTING.md を参照してください。
よくある問題：
ngrokが停止できない →
./stop-ngrok.shポート3000が使用中 →
lsof -ti:3000 | xargs kill -9"endpoint already online"エラー → 既存のngrokトンネルを停止
機能
Resources（読み込み）
file:///{key}- キーでファイルを読み込むfile:///list- すべてのファイル一覧を取得
Tools（書き込み・操作）
write_file- ファイルに内容を書き込むdelete_file- ファイルを削除search_files- テキスト検索
ログ
すべての操作は詳細にログ記録されます:
logs/combined.log- すべてのログlogs/error.log- エラーのみstderr - リアルタイム出力
各ログエントリには以下が含まれます:
タイムスタンプ
セッションID
リクエストID
操作タイプ
コンテキスト情報
ライセンス
MIT
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.