Modal MCP Server

🚀 Modal MCP サーバ

Modal ボリュームとの相互作用や、Cursor 内部から Modal アプリケーションをデプロイするための Modal サーバの実装です。

🚀 クイックスタート

このセクションでは、Modal MCP サーバのインストール、設定、および使用方法について説明します。

📦 インストール

1. このリポジトリをクローンします:

git clone https://github.com/smehmood/modal-mcp-server.git
cd modal-mcp-server

2. uv を使用して依存関係をインストールします:

uv sync

📚 ドキュメント

設定

Cursor でこの MCP サーバを使用するには、以下の設定を ~/.cursor/mcp.json ファイルに追加してください:

{
  "mcpServers": {
    "modal-mcp-server": {
      "command": "uv",
      "args": [
        "--project", "/path/to/modal-mcp-server",
        "run", "/path/to/modal-mcp-server/src/modal_mcp/server.py"
      ]
    }
  }
}

/path/to/modal-mcp-server を、クローンしたリポジトリの実際の絶対パスに置き換えてください。

前提条件

• Python 3.11 以上
• uv パッケージマネージャ
• 有効な資格情報が設定された Modal CLI
• Modal デプロイサポートについて:
  • デプロイするプロジェクトは uv を使用して依存関係を管理する必要があります
  • Modal はプロジェクトの仮想環境にインストールする必要があります

サポートツール

Modal ボリューム操作

1. Modal ボリュームの一覧表示 (list_modal_volumes)

   • 環境内のすべての Modal ボリュームを一覧表示します
   • ボリューム情報を JSON 形式で返します
   • パラメータ: なし

2. ボリューム内容の一覧表示 (list_modal_volume_contents)

   • Modal ボリューム内のファイルとディレクトリを一覧表示します
   • パラメータ:
     • volume_name: ボリュームの名前
     • path: ボリューム内のパス（デフォルト: "/"）

3. ファイルのコピー (copy_modal_volume_files)

   • Modal ボリューム内でファイルをコピーします
   • パラメータ:
     • volume_name: ボリュームの名前
     • paths: パスのリストで、最後のパスが目的地です
   • 例: ["source.txt", "dest.txt"] または ["file1.txt", "file2.txt", "dest_dir/"]

4. ファイルの削除 (remove_modal_volume_file)

   • Modal ボリュームからファイルまたはディレクトリを削除します
   • パラメータ:
     • volume_name: ボリュームの名前
     • remote_path: 削除するファイル/ディレクトリのパス
     • recursive: 再帰的に削除するかどうかのブールフラグ（デフォルト: false）

5. ファイルのアップロード (put_modal_volume_file)

   • ファイルまたはディレクトリを Modal ボリュームにアップロードします
   • パラメータ:
     • volume_name: ボリュームの名前
     • local_path: アップロードするローカルパス
     • remote_path: ボリューム内の目標パス（デフォルト: カレントディレクトリ）

6. ファイルのダウンロード (get_modal_volume_file)

   • Modal ボリュームからファイルまたはディレクトリをダウンロードします
   • パラメータ:
     • volume_name: ボリュームの名前
     • remote_path: ダウンロードするボリューム内のパス
     • local_path: ダウンロード後に保存するローカルパス（デフォルト: カレントディレクトリ）

応答形式

• 成功応答:

{
  "status": "success",
  "result": {}
}

• エラー応答:

{
  "status": "error",
  // エラー詳細はここに記載されます
}