🚀 预配置 Prefect MCP 服务器

本仓库提供了一个使用 prefect-mcp-server 包配置的 Prefect MCP 服务器设置，借助 uvx 实现了可靠的运行机制。该配置专门为配合 Cursor IDE 使用而设计，能有效提升开发效率。

🚀 快速开始

此预配置的 Prefect MCP 服务器可与 Cursor IDE 完美配合，为您的开发工作提供便利。只需按照以下步骤操作，即可轻松搭建并运行服务器。

✨ 主要特性

• 采用 prefect-mcp-server 包进行配置，确保服务器的稳定性和兼容性。
• 通过 uvx 实现可靠的运行机制，提高开发环境的一致性。
• 专为 Cursor IDE 设计，提供上下文帮助和指导，提升开发效率。

📦 安装指南

先决条件

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

安装步骤

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

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 服务器功能和使用的详细文档，请参阅 docs/prefect_mcp_documentation.md 文件。该文档包括：

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

📄 Cursor 规则

此仓库包含用于在 Cursor IDE 中与 Prefect MCP 服务器一起使用的规则，位于 .cursor/rules/ 目录中。这些规则提供上下文帮助和指导。

📎 额外信息

• 有关 Prefect 安装和使用进一步的详细信息，请参阅 Prefect 文档。
• 有关 Model Context Protocol (MCP) 的信息，请访问 MCP 文档。
• 使用 uv run 在 Cursor 推荐的配置环境中运行脚本。

祝您编码愉快！