Modal MCP Server 使用说明

项目简介

Modal MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在桥接 LLM 应用和 Modal 云平台。它允许开发者通过简单的 Python 脚本创建 serverless 应用，并将其注册为 MCP 工具，供 LLM 客户端调用。该服务器利用 Modal 平台的能力，为 LLM 应用提供动态部署和执行 Python 代码的功能。

主要功能点

工具注册与执行: 允许 LLM 客户端调用部署在 Modal 上的 Python 应用。
动态部署: 通过 'deploy' 工具，LLM 可以指示服务器在 Modal 上部署新的 Python 应用。
Prompt 模板: 提供 'summarize-notes' Prompt 模板，演示了如何根据服务器状态和客户端参数生成定制化的 Prompt。
资源管理 (示例): 虽然示例中资源管理功能较为基础，但框架已预留了资源列表和读取接口，为后续扩展资源管理功能奠定基础。
基于 Stdio 协议: 使用标准输入输出 (Stdio) 作为 MCP 服务器与客户端的通信协议。

安装步骤

安装 Modal CLI 和 Python 库: 确保已安装 Modal CLI 工具和 Python 库，并完成 Modal 的环境配置。
```
pip install modal
python3 -m modal setup
```
请参考 Modal 官方文档完成 Modal 账号注册和 CLI 工具的配置。
下载或克隆仓库: 将 'mcp-server-modal' 仓库下载到本地。
配置 MCP 服务器: 在你的 MCP 客户端（例如 Claude 桌面应用）中，配置 MCP 服务器连接信息。

服务器配置

以下是在 MCP 客户端中配置 'mcp-server-modal' 的示例 JSON 配置。你需要根据实际情况修改 '/path/to/mcp-server-modal' 为你本地仓库的路径。

{
   "mcpServers": {
        "mcp-server-modal": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-modal",
                "run",
                "modal-server"
            ]
        }
   }
}

配置参数说明:

'"mcp-server-modal"': 服务器名称，可以自定义。
'"command": "uv"': 启动服务器的命令。这里使用 'uv' (可能需要先安装 'pip install uv')，它是一个更快的 pip 和 venv 安装器，这里用来运行 Python 脚本。
'"args"': 传递给 'uv' 命令的参数列表。
- '"--directory"': 指定工作目录为 'mcp-server-modal' 仓库的根目录。
- '"/path/to/mcp-server-modal"': 请替换为 mcp-server-modal 仓库在您本地的绝对路径。
- '"run"': 'uv run' 命令用于运行 Python 模块。
- '"modal-server"': 指定要运行的 Python 模块为 'modal-server'，它对应于 'src/modal_server/init.py' 文件，该文件会启动 'server.py' 中的 MCP 服务器。

注意:

确保你的 MCP 客户端支持 Stdio 协议的 MCP 服务器。
初次运行可能需要一些时间来安装依赖和启动 Modal 环境。

基本使用方法

启动 MCP 服务器: 在配置完成后，启动你的 MCP 客户端。客户端会根据配置自动连接到 'mcp-server-modal' 服务器。

在 LLM 中使用 'deploy' 工具: 在支持 MCP 协议的 LLM 应用中，你可以指示 LLM 使用 'deploy' 工具来部署 Python 脚本到 Modal。例如，你可以向 LLM 发送指令：

请帮我部署一个 Modal 应用，代码如下：
[在此处粘贴你的 Python 代码，例如 model_app.py 中的代码]

服务器会将代码部署到 Modal，并返回部署链接。

在 LLM 中使用 'summarize-notes' Prompt: 你可以要求 LLM 使用 'summarize-notes' Prompt 来总结笔记。例如：

请使用 summarize-notes Prompt 总结一下笔记，风格为 detailed。

服务器会根据 Prompt 模板和提供的参数生成 Prompt，并返回给 LLM。

开发和调试:

仓库的 'README.md' 文件中提供了开发和调试的命令：

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-modal run modal-server

这个命令使用 '@modelcontextprotocol/inspector' 工具和 'uv' 运行服务器，方便开发者进行本地调试。

关键词