Prefect MCP Server

🚀 預製 MCP 服務器

此倉庫提供了一個 Prefect MCP 服務器配置，使用 prefect-mcp-server 包，並通過 uvx 實現可靠的運行機制。該配置專為與 Cursor IDE 配合使用而設計，能為開發工作帶來便利。

🚀 快速開始

本配置適用於與 Cursor IDE 配合使用的 Prefect MCP 服務器。按照以下步驟操作，即可快速搭建並啟動服務器。

✨ 主要特性

• 專為與 Cursor IDE 配合使用而設計。
• 通過 uvx 實現可靠的運行機制。
• 提供增強的可靠性和一致性，確保與安裝的確切包版本一起使用。

📦 安裝指南

先決條件

• 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 中指定的命令。

📚 詳細文檔

在 docs/prefect_mcp_documentation.md 文件中提供了關於 Prefect MCP 服務器功能和使用的詳細文檔。文檔內容包括：

• 完整的工具列表及其參數
• 安裝和配置說明
• 使用不同 MCP 客戶端的示例
• Prefect 3.0 兼容性信息

🔖 Cursor 規則

此倉庫包含用於與 Prefect MCP 服務器一起工作的 Cursor 規則，位於 .cursor/rules/ 目錄中。這些規則為在 Cursor IDE 中使用 Prefect MCP 提供上下文幫助和指導。

📎 額外信息

• 關於 Prefect 安裝和使用的更多信息，請參閱 Prefect 文檔。
• 有關模型上下文協議（MCP）的詳細信息，請訪問 MCP 文檔。
• 使用 uv run 在推薦的環境中運行腳本，如 Cursor 所建議。

祝您編碼愉快！