Prefect MCP Server
완벽한 MCP 서버
Prefect를 위한 MCP(Model Context Protocol) 서버 구현을 통해 AI 어시스턴트가 자연어를 통해 Prefect와 상호 작용할 수 있습니다.
특징
이 MCP 서버는 다음 Prefect API에 대한 액세스를 제공합니다.
흐름 관리 : 흐름 나열, 가져오기 및 삭제
흐름 실행 관리 : 흐름 실행을 생성, 모니터링 및 제어합니다.
배포 관리 : 배포 및 일정 관리
작업 실행 관리 : 작업 실행을 모니터링하고 제어합니다.
작업 대기열 관리 : 작업 대기열을 생성하고 관리합니다.
블록 관리 : 블록 유형 및 문서 액세스
변수 관리 : 변수 생성 및 관리
작업 공간 관리 : 작업 공간에 대한 정보를 얻으세요
Related MCP server: n8n MCP Server
구성
다음 환경 변수를 설정하세요.
지엑스피1
용법
MCP 서버를 실행하고 다음을 완료하세요.
docker compose up입력 예시
연결되면 AI 비서가 자연어를 사용하여 사용자가 Prefect와 상호 작용하도록 도울 수 있습니다. 예:
"내 모든 흐름을 보여줘"
"어제 실패한 모든 흐름 실행을 나열하세요"
"데이터 처리 배포를 시작하세요"
"일일 보고 배포 일정을 일시 중지합니다."
"마지막 ETL 흐름 실행의 상태는 무엇입니까?"
개발
몇몇 엔드포인트는 아직 구현되지 않았습니다.
새로운 기능 추가
기존 API에 새 기능을 추가하려면:
src/mcp_prefect의 적절한 모듈에 함수를 추가합니다.모듈의
get_all_functions()목록에 함수를 추가합니다.
새로운 API 유형을 추가하려면:
enums.py의APIType에 새 유형을 추가합니다.src/prefect/에 새 모듈을 만듭니다.새로운 API 유형을 포함하도록
main.py업데이트하세요.
사용 예:
{
"mcpServers": {
"mcp-prefect": {
"command": "mcp-prefect",
"args": [
"--transport", "sse"
],
"env": {
"PYTHONPATH": "/path/to/your/project/directory"
},
"cwd": "/path/to/your/project/directory"
}
}
}Available Tools
46 toolscancel_flow_runC
Cancel a flow run.
Args: flow_run_id: The flow run UUID
Returns: Confirmation message
Inputs: flow_run_id (required).
create_flow_run_from_deploymentC
Create a flow run from a deployment.
Args: deployment_id: The deployment UUID parameters: Optional parameters to pass to the flow run name: Optional name for the flow run tags: Optional tags for the flow run idempotency_key: Optional idempotency key
Returns: Details of the created flow run
Inputs: deployment_id (required), idempotency_key, name, parameters, +1 more.
create_variableB
Create a variable.
Args: name: The variable name value: The variable value (can be string, dict, list, etc.) tags: Optional tags
Returns: Details of the created variable
Inputs: name (required), value (required), tags.
create_work_queueB
Create a work queue.
Args: name: The name for the work queue description: Optional description is_paused: Whether the queue should be paused upon creation concurrency_limit: Optional concurrency limit
Returns: Details of the created work queue
Inputs: name (required), concurrency_limit, description, is_paused.
delete_block_documentB
Delete a block document by ID.
Args: block_document_id: The block document UUID
Returns: Confirmation message
Inputs: block_document_id (required).
delete_deploymentC
Delete a deployment by ID.
Args: deployment_id: The deployment UUID
Returns: Confirmation message
Inputs: deployment_id (required).
delete_flowB
Delete a flow by ID.
Args: flow_id: The flow UUID
Returns: Confirmation message
Inputs: flow_id (required).
delete_flow_runC
Delete a flow run.
Args: flow_run_id: The flow run UUID
Returns: Confirmation message
Inputs: flow_run_id (required).
delete_variableC
Delete a variable by name.
Args: name: The variable name
Returns: Confirmation message
Inputs: name (required).
delete_work_queueC
Delete a work queue by ID.
Args: work_queue_id: The work queue UUID
Returns: Confirmation message
Inputs: work_queue_id (required).
get_block_documentB
Get a block document by ID.
Args: block_document_id: The block document UUID
Returns: Block document details
Inputs: block_document_id (required).
get_block_documentsB
Get block documents by block type.
Args: block_type_slug: The block type slug limit: Maximum number of block documents to return offset: Number of block documents to skip name: Filter by name pattern
Returns: A list of block documents with their details
Inputs: block_type_slug (required), limit, name, offset.
get_block_typeC
Get a block type by slug.
Args: slug: The block type slug
Returns: Block type details
Inputs: slug (required).
get_block_typesB
Get a list of block types with optional filtering.
Args: limit: Maximum number of block types to return offset: Number of block types to skip slug: Filter by slug pattern
Returns: A list of block types with their details
Inputs: limit, offset, slug.
get_current_workspaceC
Get the current workspace.
Returns: Details of the current workspace
Inputs: no named parameters.
get_deploymentC
Get details of a specific deployment by ID.
Args: deployment_id: The deployment UUID
Returns: Deployment details
Inputs: deployment_id (required).
get_deploymentsB
Get a list of deployments with optional filtering.
Args: limit: Maximum number of deployments to return offset: Number of deployments to skip flow_name: Filter by flow name name: Filter by deployment name tags: Filter by tags is_schedule_active: Filter by schedule active status work_queue_name: Filter by work queue name
Returns: A list of deployments with their details
Inputs: flow_name, is_schedule_active, limit, name, +3 more.
get_deployment_scheduleC
Get a deployment's schedule.
Args: deployment_id: The deployment UUID
Returns: Schedule details
Inputs: deployment_id (required).
get_flowC
Get details of a specific flow by ID.
Args: flow_id: The flow UUID
Returns: Flow details
Inputs: flow_id (required).
get_flow_runB
Get details of a specific flow run by ID.
Args: flow_run_id: The flow run UUID
Returns: Flow run details
Inputs: flow_run_id (required).
get_flow_runsB
Get a list of flow runs with optional filtering.
Args: limit: Maximum number of flow runs to return offset: Number of flow runs to skip flow_name: Filter by flow name state_type: Filter by state type (e.g., "RUNNING", "COMPLETED", "FAILED") state_name: Filter by state name deployment_id: Filter by deployment ID tags: Filter by tags start_time_before: ISO formatted datetime string start_time_after: ISO formatted datetime string
Returns: A list of flow runs with their details
Inputs: deployment_id, flow_name, limit, offset, +5 more.
get_flow_runs_by_flowB
Get flow runs for a specific flow.
Args: flow_id: The flow UUID limit: Maximum number of flow runs to return offset: Number of flow runs to skip state_type: Filter by state type (e.g., "RUNNING", "COMPLETED", "FAILED")
Returns: A list of flow runs for the specified flow
Inputs: flow_id (required), limit, offset, state_type.
get_flowsB
Get a list of flows with optional filtering.
Args: limit: Maximum number of flows to return offset: Number of flows to skip flow_name: Filter flows by name tags: Filter flows by tags created_after: ISO formatted datetime string for filtering flows created after this time created_before: ISO formatted datetime string for filtering flows created before this time
Returns: A list of flows with their details
Inputs: created_after, created_before, flow_name, limit, +2 more.
get_healthC
Get health status of the Prefect server.
Returns: Health status information
Inputs: no named parameters.
get_task_runC
Get details of a specific task run by ID.
Args: task_run_id: The task run UUID
Returns: Task run details
Inputs: task_run_id (required).
get_task_runsB
Get a list of task runs with optional filtering.
Args: limit: Maximum number of task runs to return offset: Number of task runs to skip task_name: Filter by task name state_type: Filter by state type (e.g., "RUNNING", "COMPLETED", "FAILED") state_name: Filter by state name tags: Filter by tags start_time_before: ISO formatted datetime string start_time_after: ISO formatted datetime string
Returns: A list of task runs with their details
Inputs: limit, offset, start_time_after, start_time_before, +4 more.
get_task_runs_by_flow_runB
Get task runs for a specific flow run.
Args: flow_run_id: The flow run UUID limit: Maximum number of task runs to return offset: Number of task runs to skip state_type: Filter by state type (e.g., "RUNNING", "COMPLETED", "FAILED")
Returns: A list of task runs for the specified flow run
Inputs: flow_run_id (required), limit, offset, state_type.
get_variableC
Get a variable by name.
Args: name: The variable name
Returns: Variable details
Inputs: name (required).
get_variablesB
Get a list of variables with optional filtering.
Args: limit: Maximum number of variables to return offset: Number of variables to skip name: Filter by name pattern
Returns: A list of variables with their details
Inputs: limit, name, offset.
get_work_queueC
Get details of a specific work queue by ID.
Args: work_queue_id: The work queue UUID
Returns: Work queue details
Inputs: work_queue_id (required).
get_work_queue_by_nameC
Get a work queue by name.
Args: name: The work queue name
Returns: Work queue details
Inputs: name (required).
get_work_queuesC
Get a list of work queues with optional filtering.
Args: limit: Maximum number of work queues to return offset: Number of work queues to skip name: Filter by name is_paused: Filter by paused status
Returns: A list of work queues with their details
Inputs: is_paused, limit, name, offset.
get_workspaceC
Get a workspace by ID.
Args: workspace_id: The workspace UUID
Returns: Workspace details
Inputs: workspace_id (required).
get_workspace_by_handleC
Get a workspace by its handle.
Args: account_handle: The account handle workspace_handle: The workspace handle
Returns: Workspace details
Inputs: account_handle (required), workspace_handle (required).
get_workspacesB
Get a list of accessible workspaces.
Args: limit: Maximum number of workspaces to return offset: Number of workspaces to skip name: Filter workspaces by name (note: filtering may not be supported by all Prefect versions)
Returns: A list of workspaces with their details
Inputs: limit, name, offset.
pause_deployment_scheduleC
Pause a deployment's schedule.
Args: deployment_id: The deployment UUID
Returns: Confirmation message
Inputs: deployment_id (required).
pause_work_queueB
Pause a work queue.
Args: work_queue_id: The work queue UUID
Returns: Details of the updated work queue
Inputs: work_queue_id (required).
restart_flow_runC
Restart a flow run.
Args: flow_run_id: The flow run UUID
Returns: Details of the new flow run
Inputs: flow_run_id (required).
resume_deployment_scheduleC
Resume a deployment's schedule.
Args: deployment_id: The deployment UUID
Returns: Confirmation message
Inputs: deployment_id (required).
resume_work_queueB
Resume a work queue.
Args: work_queue_id: The work queue UUID
Returns: Details of the updated work queue
Inputs: work_queue_id (required).
set_deployment_scheduleB
Set a deployment's schedule.
Args: deployment_id: The deployment UUID cron: Cron expression for the schedule interval_seconds: Alternative to cron - interval in seconds anchor_date: Required for interval schedules - the anchor date timezone: Timezone for the schedule
Returns: Updated schedule details
Inputs: deployment_id (required), anchor_date, cron, interval_seconds, +1 more.
set_flow_run_stateB
Set a flow run's state.
Args: flow_run_id: The flow run UUID state: The new state to set (e.g., "SCHEDULED", "RUNNING", "COMPLETED", "FAILED") message: An optional message explaining the state change
Returns: Result of the state change operation
Inputs: flow_run_id (required), state (required), message.
set_task_run_stateB
Set a task run's state.
Args: task_run_id: The task run UUID state: The new state to set (e.g., "SCHEDULED", "RUNNING", "COMPLETED", "FAILED") message: An optional message explaining the state change
Returns: Result of the state change operation
Inputs: state (required), task_run_id (required), message.
update_deploymentB
Update a deployment.
Args: deployment_id: The deployment UUID name: New name for the deployment description: New description version: New version tags: New tags parameters: New parameters work_queue_name: New work queue name
Returns: Details of the updated deployment
Inputs: deployment_id (required), description, name, parameters, +3 more.
update_variableC
Update a variable.
Args: name: The variable name value: New value tags: New tags
Returns: Details of the updated variable
Inputs: name (required), tags, value.
update_work_queueB
Update a work queue.
Args: work_queue_id: The work queue UUID name: New name description: New description is_paused: New paused status concurrency_limit: New concurrency limit
Returns: Details of the updated work queue
Inputs: work_queue_id (required), concurrency_limit, description, is_paused, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 46 tools
Each tool has a clearly distinct purpose targeting specific resources and actions in the Prefect domain, such as flows, deployments, flow runs, task runs, variables, work queues, blocks, and workspaces. There is no ambiguity or overlap; for example, get_flow_runs and get_task_runs are clearly separated by resource type, and create/update/delete operations are consistently differentiated.
Tool names follow a highly consistent verb_noun pattern throughout, with verbs like get, create, update, delete, pause, resume, set, and cancel paired with specific nouns. All names use snake_case uniformly, and patterns like get_X and get_Xs for list operations are predictable, making the set easy to navigate.
With 46 tools, the count is high and may feel heavy for typical MCP server purposes, though it aligns with Prefect's comprehensive API coverage. While each tool serves a distinct function, the sheer number could overwhelm agents, placing it in the borderline range where 16-25 tools is considered heavy, and 46 exceeds that significantly.
The tool set provides complete CRUD/lifecycle coverage for all core Prefect resources, including flows, deployments, flow runs, task runs, variables, work queues, blocks, and workspaces. It supports operations like creation, retrieval, updating, deletion, state management, scheduling, and health checks, with no obvious gaps that would hinder agent workflows.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceA Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.5,915 npm623MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to interact with n8n workflows through natural language, supporting actions like listing, creating, updating, executing and monitoring workflows.364 npm1,630MIT
- AlicenseAqualityDmaintenanceA server that enables interacting with Prefect workflow automation tools through the Model Context Protocol, offering enhanced reliability through uvx running mechanism and seamless integration with Cursor IDE.171,021 PyPI7MIT

prefect-mcp-serverofficial
AlicenseAqualityCmaintenanceAn MCP server for interacting with Prefect resources, enabling AI assistants to monitor, manage, and debug workflows.1455MIT