Fortunto2 Prefect MCP Server

🚀 預配置 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 推薦的配置環境中運行腳本。

祝您編碼愉快！