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

npm start

# 認証なし（開発用）
MCP_MODE=http npm run dev:http

# 認証あり（推奨）
export MCP_API_KEY=$(openssl rand -hex 32)
./start-http.sh

# MCPサーバー + ngrokを同時起動
./start-all.sh

# ターミナル1: MCPサーバー
./start-http.sh

# ターミナル2: ngrok
./start-ngrok.sh

ngrok http 3000

# 開発モード
npm run dev

# 本番実行
npm start

# 開発モード（認証なし）
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-key

# 別のターミナルでngrokを起動
ngrok http 3000

npm run inspect

{
  "mcpServers": {
    "universal-mcp": {
      "command": "node",
      "args": ["/path/to/universal-mcp-server/build/index.js"]
    }
  }
}

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"