MCP Dos

🚀 MCP DOS - クラシックDOSゲーミングサーバ

Model Context Protocol (MCP)サーバで、js-dosエミュレーションを通じてクラシックなDOSゲームにアクセスできます。DOOM、スーパーマリオ、テトリス、デューク・ニューケム3Dなどの伝説的なゲームをAIアシスタントから直接プレイできます。

✨ 主な機能

• クラシックDOSゲーム：DOOM、スーパーマリオ、テトリス、デューク・ニューケム3Dなどの象徴的なDOSゲームをプレイできます。
• ウェブベースのエミュレーション：ブラウザで本格的なDOSゲーム体験を提供するjs-dosを使用しています。
• 全画面サポート：適切なコントロールで全画面モードでゲームを楽しめます。
• キーボードマッピング：各ゲームには画面上のコントロールとともに事前に設定されたキーマッピングがあります。
• サーバ管理：ゲーミングサーバの起動、停止、管理を行うツールが用意されています。

🎮 利用可能なゲーム

• DOOM (doom) - 伝説的なファーストパーソンシューター
• スーパーマリオ (super-mario) - クラシックなプラットフォーマーアドベンチャー
• テトリス (tetris) - 不朽のパズルゲーム
• デューク・ニューケム3D (duke3d) - アクション溢れるFPSアドベンチャー

🚀 クイックスタート

このサーバをMCPクライアント設定に追加します：

{
  "mcpServers": {
    "mcp-dos": {
      "command": "npx",
      "args": ["-y", "mcp-dos"]
    }
  }
}

💻 使用例

ゲームコントロール

各ゲームには画面上に事前に設定されたコントロールが表示されます：

DOOM

• 矢印キー：移動（前/後/左/右）
• W：使用
• S：発射
• A/D：左右に横移動
• Enter：メニューナビゲーション

スーパーマリオ

• 左/右矢印キー：移動
• Alt：ジャンプ

テトリス

• 7/8：左右に移動
• 9：ピースを回転
• Space：ピースを落下
• Enter：メニューナビゲーション

デューク・ニューケム3D

• 矢印キー：移動
• Ctrl：発射
• A：ジャンプ
• Enter：メニューナビゲーション

利用可能なツール

1. List DOS Games

サーバを通じてプレイできるすべての利用可能なDOSゲームをリストします。 戻り値:

• 利用可能なゲームのスラッグの配列
• open-dosツールを使用してゲームをプレイする方法の説明

2. open-dos

js-dosエミュレーションを使用して特定のDOSゲームをブラウザウィンドウで開いてプレイします。 パラメータ:

• game (文字列): プレイするDOSゲームのスラッグ（例: 'doom', 'super-mario', 'tetris', 'duke3d'） 機能:
• 新しいブラウザウィンドウでゲームを起動します。
• 画面上にゲーム固有のコントロールを表示します。
• 全画面サポート
• 本格的なDOSゲーム体験

3. close-app

実行中のmcp-dosサーバインスタンスを閉じます。 パラメータ:

• port (数値): 閉じるサーバのポート番号 使用例:
• サーバインスタンスをクリーンアップする
• ポートの競合を解消する
• サーバのメンテナンス

開発

# 依存関係のインストール
pnpm install

# プロジェクトのビルド
pnpm build

# サーバの起動
pnpm start

📚 ドキュメント

要件

• Node.js ≥20.0.0
• JavaScriptが有効になっている最新のウェブブラウザ
• js-dos CDNリソース用のインターネット接続

このプロジェクトは xmcp フレームワークを使用して構築されています。