Prefect MCP 服务器

本仓库提供了一个使用 prefect-mcp-server 包的 Prefect MCP 服务器配置，并通过 uvx 提供可靠的运行机制。此配置专为 Cursor IDE 使用而定制。

前提条件

• Python 3.9 或更高版本。
• 首选的虚拟环境工具（例如 uv）用于管理 Python 环境。
• Prefect 3 (有关安装说明，请参阅 Prefect 文档)。

安装

创建并激活您的虚拟环境，然后安装 Prefect MCP Server：

uv venv --python 3.12 && source .venv/bin/activate
uv pip install -U prefect-mcp-server

配置

服务器通过 .cursor/mcp.json 文件进行配置。更新后的配置如下：

{
  "mcpServers": {
    "prefect": {
      "command": "uvx",
      "args": [
        "prefect-mcp-server"
      ],
      "env": {}
    }
  }
}

此配置确保服务器使用 uvx 命令以及通过 uv pip install 安装的确切包版本。 这种方法在您的开发环境中提供了增强的可靠性和一致性。

环境变量

设置以下环境变量以配置您的 Prefect 环境。 您可以在项目根目录中创建一个名为 .env 的文件，其中包含如下条目：

PREFECT_API_URL=http://localhost:4200/api

此外，如果需要，设置其他环境变量，例如 PREFECT_API_KEY 以验证您的 Prefect 服务器或 Prefect Cloud。

运行服务器

要启动服务器，您可以运行以下命令：

uv run <script>

或者，如果您正在使用 Cursor IDE 及其配置，服务器将自动使用 .cursor/mcp.json 中指定的命令调用。

文档

有关 Prefect MCP Server 功能和用法的详细文档，请参见 docs/prefect_mcp_documentation.md 文件。 该文档包括：

• 可用工具及其参数的完整列表
• 安装和配置说明
• 与不同 MCP 客户端一起使用的示例
• Prefect 3.0 兼容性信息

Cursor 规则

本仓库包含用于使用 Prefect MCP Server 的 Cursor 规则，位于 .cursor/rules/ 目录中。 这些规则在使用 Cursor IDE 中的 Prefect MCP 时提供上下文帮助和指导。

附加信息

• 有关 Prefect 安装和用法的更多详细信息，请参阅 Prefect 文档。
• 有关模型上下文协议 (MCP) 的信息，请参阅 MCP 文档。
• 按照 Cursor 的建议，使用 uv run 在配置的环境中运行脚本。

编码愉快！