项目简介
本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在帮助用户将Python脚本部署到 Modal 云平台,并作为工具提供给大型语言模型 (LLM) 使用。通过此MCP服务器,LLM可以调用部署在Modal上的Python应用,实现更丰富的功能。
主要功能点
- 工具注册与调用: 允许LLM客户端调用预定义的 "deploy" 工具,将Python脚本部署为Modal应用。
- 资源管理 (示例): 提供资源列表和读取接口 (示例实现,可扩展)。
- Prompt模板 (示例): 提供 Prompt 模板管理和获取接口 (示例 "summarize-notes" prompt)。
- 基于Modal平台: 利用Modal的serverless特性,简化Python应用的部署和运行。
安装步骤
-
安装 Modal CLI 工具并完成初始化设置:
pip install modal python3 -m modal setup确保您已正确安装 Modal CLI 并完成账户配置。
-
配置 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'。
基本使用方法
- 启动 MCP 服务器: 根据上述配置,MCP 客户端将使用配置的 'command' 和 'args' 启动 'mcp-server-modal' 服务器。
- 在 LLM 中使用工具: 在支持 MCP 协议的 LLM 应用 (如 Claude) 中,您可以指示 LLM 使用 'deploy' 工具来部署 Python 脚本到 Modal。例如,您可以向 Claude 发送指令:“请帮我部署一个 Python 脚本到 Modal”。
- LLM 调用工具: 当 LLM 需要部署 Python 脚本时,它会调用 'mcp-server-modal' 服务器提供的 'deploy' 工具,并将脚本内容作为参数传递。
- 服务器部署应用: 'mcp-server-modal' 服务器接收到工具调用请求后,会使用 Modal CLI 将提供的 Python 脚本部署到 Modal 平台。
- 返回部署结果: 服务器会将部署结果返回给 LLM 客户端。
信息
分类
开发者工具