mcp -modal

This MCP server enables deploying Python scripts to Modal directly from Claude. The mcp-server-modal component runs a Modal-based server from a local directory, allowing you to package Python code as Modal applications and run them in the cloud. The filesystem server entry is provided to integrate Claude’s filesystem-based workflows, enabling file-based interactions with Claude’s environment and the Modal deployment workflow. In practice, you generate the Python script or project in Claude, configure it to run as a Modal application, and then deploy or run the application via Modal using the generated link or API. Once deployed, you’ll be able to share the resulting Modal app link with collaborators and test the deployment from within Claude or via the Modal interface.

Prerequisites:

• Ensure Python is installed on your system.

• Install Modal and set up your Modal environment:

  pip install modal python3 -m modal setup

Install/prepare the MCP configuration in your Claude desktop app by including the following mcpServers block:

{
  "mcpServers": {
    "mcp-server-modal": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-modal",
        "run",
        "modal-server"
      ]
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/user/Desktop/",
        "/path/to/other/dir"
      ]
    }
  }
}

Notes:

• Replace /path/to/mcp-server-modal with the actual path to your local mcp-server-modal directory.
• Replace /Users/user/Desktop/ and /path/to/other/dir with the desired directories for the filesystem server if you intend to use it.
• Confirm Modal credentials and environment are configured in your Modal account before deployment.

Tips and notes:

• The mcp-server-modal entry uses the uv command to run a Modal server from a local directory. Ensure your project at that directory contains the Modal application entrypoint as expected by your setup.
• The filesystem server entry uses npx to install and run the server-filesystem integration; this is useful when Claude’s workspace relies on filesystem-backed interactions.
• Replace all placeholder paths with real paths before deploying.
• If you encounter permission or path errors, verify that your working directory has the appropriate read/write permissions and that Modal is properly authenticated in your environment.
• For development, you can use the inspector command shown in the README to test the server locally: npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-modal run modal-server