モーダルMCPサーバー

Name: Modal MCP Server
Author: smehmood

モーダルボリュームと対話し、カーソル内からモーダルアプリケーションを展開するための MCP サーバー実装。

インストール

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

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

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

uv sync

Related MCP server: MCP Shell Server

構成

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パッケージマネージャー
有効な資格情報で構成されたモーダル CLI
モーダルデプロイのサポート:
- デプロイされるプロジェクトは依存関係の管理にuvを使用する必要があります
- モーダルはプロジェクトの仮想環境にインストールする必要があります

サポートされているツール

モーダルボリューム操作

モーダルボリュームの一覧表示( list_modal_volumes )
- 環境内のすべてのモーダルボリュームを一覧表示します
- JSON形式のボリューム情報を返します
- パラメータ: なし
ボリュームの内容の一覧表示( list_modal_volume_contents )
- モーダルボリューム内のファイルとディレクトリを一覧表示します
- パラメータ:
  - volume_name : モーダルボリュームの名前
  - path : ボリューム内のパス（デフォルト: "/"）
ファイルのコピー( copy_modal_volume_files )
- モーダルボリューム内のファイルをコピーします
- パラメータ:
  - volume_name : モーダルボリュームの名前
  - paths : 最後のパスが宛先であるパスのリスト
- 例: ["source.txt", "dest.txt"]または["file1.txt", "file2.txt", "dest_dir/"]
ファイルを削除( remove_modal_volume_file )
- モーダルボリュームからファイルまたはディレクトリを削除します
- パラメータ:
  - volume_name : モーダルボリュームの名前
  - remote_path : 削除するファイル/ディレクトリへのパス
  - recursive : 再帰削除のブールフラグ（デフォルト: false）
ファイルのアップロード( put_modal_volume_file )
- ファイルまたはディレクトリをモーダルボリュームにアップロードします
- パラメータ:
  - volume_name : モーダルボリュームの名前
  - local_path : アップロードするローカルファイル/ディレクトリへのパス
  - remote_path : アップロード先のボリューム内のパス（デフォルト: "/"）
  - force : 既存のファイルを上書きするためのブールフラグ（デフォルト: false）
ファイルをダウンロード( get_modal_volume_file )
- モーダルボリュームからファイルをダウンロードします
- パラメータ:
  - volume_name : モーダルボリュームの名前
  - remote_path : ダウンロードするボリューム内のファイル/ディレクトリへのパス
  - local_destination : ダウンロードしたファイルを保存するローカルパス（デフォルト: 現在のディレクトリ）
  - force : 既存のファイルを上書きするためのブールフラグ（デフォルト: false）
- 注: ファイルの内容を標準出力に書き込むには、 local_destinationとして "-" を使用します。

モーダル展開

モーダルアプリをデプロイする( deploy_modal_app )
- モーダルアプリケーションを展開する
- パラメータ:
  - absolute_path_to_app : モーダルアプリケーションファイルへの絶対パス
- 注: モーダルアプリを含むプロジェクトでは次の条件を満たす必要があります。
  - 依存関係の管理にはuvを使用する
  - modal CLIを仮想環境にインストールする

応答フォーマット

すべてのツールは、操作の種類に応じて若干の違いはあるものの、標準化された形式で応答を返します。

# JSON operations (list volumes, list contents): { "success": True, "data": {...} # JSON data from Modal CLI } # File operations (put, get, copy, remove): { "success": True, "message": "Operation successful message", "command": "executed command string", "stdout": "command output", # if any "stderr": "error output" # if any } # Error case (all operations): { "success": False, "error": "Error message describing what went wrong", "command": "executed command string", # for file operations "stdout": "command output", # if available "stderr": "error output" # if available }