项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在帮助用户将Python脚本部署到 Modal 云平台,并作为工具提供给大型语言模型 (LLM) 使用。通过此MCP服务器,LLM可以调用部署在Modal上的Python应用,实现更丰富的功能。

主要功能点

  • 工具注册与调用: 允许LLM客户端调用预定义的 "deploy" 工具,将Python脚本部署为Modal应用。
  • 资源管理 (示例): 提供资源列表和读取接口 (示例实现,可扩展)。
  • Prompt模板 (示例): 提供 Prompt 模板管理和获取接口 (示例 "summarize-notes" prompt)。
  • 基于Modal平台: 利用Modal的serverless特性,简化Python应用的部署和运行。

安装步骤

  1. 安装 Modal CLI 工具并完成初始化设置:

    pip install modal
    python3 -m modal setup

    确保您已正确安装 Modal CLI 并完成账户配置。

  2. 配置 MCP 服务器: 在您的 MCP 客户端 (例如 Claude 桌面应用) 中,配置 'mcp-server-modal' 服务器。

服务器配置

以下是在 MCP 客户端中配置 'mcp-server-modal' 服务器的示例 JSON 配置。请根据您的实际情况修改路径。

{
   "mcpServers": {
        "mcp-server-modal": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-modal",  // 替换为 mcp-server-modal 仓库在您本地的路径
                "run",
                "modal-server"
            ]
        }
   }
}
  • 'server name': 'mcp-server-modal' (服务器名称,可自定义)
  • 'command': 'uv' (启动服务器的命令,这里使用 'uv',可能需要根据实际环境调整)
  • 'args': 启动参数列表
    • '--directory': '/path/to/mcp-server-modal' (指向 'mcp-server-modal' 仓库根目录的路径,请替换为实际路径)
    • 'run': 运行命令,指示执行服务器
    • 'modal-server': 服务器入口点,对应 'src/modal_server/init.py' 中定义的 'main' 函数

注意: 请将 '/path/to/mcp-server-modal' 替换为您本地 'mcp-server-modal' 仓库的实际路径。您可能需要根据您的环境调整 'command' 和 'args'。

基本使用方法

  1. 启动 MCP 服务器: 根据上述配置,MCP 客户端将使用配置的 'command' 和 'args' 启动 'mcp-server-modal' 服务器。
  2. 在 LLM 中使用工具: 在支持 MCP 协议的 LLM 应用 (如 Claude) 中,您可以指示 LLM 使用 'deploy' 工具来部署 Python 脚本到 Modal。例如,您可以向 Claude 发送指令:“请帮我部署一个 Python 脚本到 Modal”。
  3. LLM 调用工具: 当 LLM 需要部署 Python 脚本时,它会调用 'mcp-server-modal' 服务器提供的 'deploy' 工具,并将脚本内容作为参数传递。
  4. 服务器部署应用: 'mcp-server-modal' 服务器接收到工具调用请求后,会使用 Modal CLI 将提供的 Python 脚本部署到 Modal 平台。
  5. 返回部署结果: 服务器会将部署结果返回给 LLM 客户端。

信息

分类

开发者工具