Prefect MCP Server

Prefect MCP 服务

此仓库提供 Prefect MCP 服务配置，使用 prefect-mcp-server 包，并通过 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 文档。
• 有关 Model Context Protocol (MCP) 的信息，请参阅 MCP 文档。
• 按照 Cursor 的建议，使用 uv run 在已配置的环境中运行脚本。

祝编码愉快！