mcp-server-apache-airflow 0.2.1__tar.gz → 0.2.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/PKG-INFO +82 -7
  2. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/README.md +81 -6
  3. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/pyproject.toml +2 -2
  4. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/.gitignore +0 -0
  5. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/LICENSE +0 -0
  6. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/__init__.py +0 -0
  7. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/__main__.py +0 -0
  8. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/__init__.py +0 -0
  9. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/airflow_client.py +0 -0
  10. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/config.py +0 -0
  11. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/connection.py +0 -0
  12. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/dag.py +0 -0
  13. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/dagrun.py +0 -0
  14. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/dagstats.py +0 -0
  15. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/dataset.py +0 -0
  16. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/eventlog.py +0 -0
  17. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/importerror.py +0 -0
  18. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/monitoring.py +0 -0
  19. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/plugin.py +0 -0
  20. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/pool.py +0 -0
  21. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/provider.py +0 -0
  22. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/taskinstance.py +0 -0
  23. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/variable.py +0 -0
  24. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/airflow/xcom.py +0 -0
  25. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/enums.py +0 -0
  26. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/envs.py +0 -0
  27. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/main.py +0 -0
  28. {mcp_server_apache_airflow-0.2.1 → mcp_server_apache_airflow-0.2.2}/src/server.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-server-apache-airflow
3
- Version: 0.2.1
3
+ Version: 0.2.2
4
4
  Summary: Model Context Protocol (MCP) server for Apache Airflow
5
5
  Project-URL: Homepage, https://github.com/yangkyeongmo/mcp-server-apache-airflow
6
6
  Project-URL: Repository, https://github.com/yangkyeongmo/mcp-server-apache-airflow.git
@@ -31,6 +31,10 @@ Description-Content-Type: text/markdown
31
31
 
32
32
  A Model Context Protocol (MCP) server implementation for Apache Airflow, enabling seamless integration with MCP clients. This project provides a standardized way to interact with Apache Airflow through the Model Context Protocol.
33
33
 
34
+ <a href="https://glama.ai/mcp/servers/e99b6vx9lw">
35
+ <img width="380" height="200" src="https://glama.ai/mcp/servers/e99b6vx9lw/badge" alt="Server for Apache Airflow MCP server" />
36
+ </a>
37
+
34
38
  ## About
35
39
 
36
40
  This project implements a [Model Context Protocol](https://modelcontextprotocol.io/introduction) server that wraps Apache Airflow's REST API, allowing MCP clients to interact with Airflow in a standardized way. It uses the official Apache Airflow client library to ensure compatibility and maintainability.
@@ -44,25 +48,29 @@ This project implements a [Model Context Protocol](https://modelcontextprotocol.
44
48
  | Get DAG Details | `/api/v1/dags/{dag_id}` | ✅ |
45
49
  | Pause DAG | `/api/v1/dags/{dag_id}` | ✅ |
46
50
  | Unpause DAG | `/api/v1/dags/{dag_id}` | ✅ |
47
- | Update DAG | `/api/v1/dags/{dag_id}` | ✅ | |
51
+ | Update DAG | `/api/v1/dags/{dag_id}` | ✅ |
48
52
  | Delete DAG | `/api/v1/dags/{dag_id}` | ✅ |
53
+ | Get DAG Source | `/api/v1/dagSources/{file_token}` | ✅ |
54
+ | Patch Multiple DAGs | `/api/v1/dags` | ✅ |
55
+ | Reparse DAG File | `/api/v1/dagSources/{file_token}/reparse` | ✅ |
49
56
  | **DAG Runs** | | |
50
57
  | List DAG Runs | `/api/v1/dags/{dag_id}/dagRuns` | ✅ |
51
58
  | Create DAG Run | `/api/v1/dags/{dag_id}/dagRuns` | ✅ |
52
59
  | Get DAG Run Details | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}` | ✅ |
53
60
  | Update DAG Run | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}` | ✅ |
54
61
  | Delete DAG Run | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}` | ✅ |
62
+ | Get DAG Runs Batch | `/api/v1/dags/~/dagRuns/list` | ✅ |
63
+ | Clear DAG Run | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/clear` | ✅ |
64
+ | Set DAG Run Note | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/setNote` | ✅ |
65
+ | Get Upstream Dataset Events | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/upstreamDatasetEvents` | ✅ |
55
66
  | **Tasks** | | |
56
67
  | List DAG Tasks | `/api/v1/dags/{dag_id}/tasks` | ✅ |
57
68
  | Get Task Details | `/api/v1/dags/{dag_id}/tasks/{task_id}` | ✅ |
58
69
  | Get Task Instance | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}` | ✅ |
59
70
  | List Task Instances | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances` | ✅ |
60
71
  | Update Task Instance | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}` | ✅ |
61
- | **System** | | |
62
- | Get Import Errors | `/api/v1/importErrors` | ✅ |
63
- | Get Import Error Details | `/api/v1/importErrors/{import_error_id}` | ✅ |
64
- | Get Health Status | `/api/v1/health` | ✅ |
65
- | Get Version | `/api/v1/version` | ✅ |
72
+ | Clear Task Instances | `/api/v1/dags/{dag_id}/clearTaskInstances` | ✅ |
73
+ | Set Task Instances State | `/api/v1/dags/{dag_id}/updateTaskInstancesState` | ✅ |
66
74
  | **Variables** | | |
67
75
  | List Variables | `/api/v1/variables` | ✅ |
68
76
  | Create Variable | `/api/v1/variables` | ✅ |
@@ -75,6 +83,45 @@ This project implements a [Model Context Protocol](https://modelcontextprotocol.
75
83
  | Get Connection | `/api/v1/connections/{connection_id}` | ✅ |
76
84
  | Update Connection | `/api/v1/connections/{connection_id}` | ✅ |
77
85
  | Delete Connection | `/api/v1/connections/{connection_id}` | ✅ |
86
+ | Test Connection | `/api/v1/connections/test` | ✅ |
87
+ | **Pools** | | |
88
+ | List Pools | `/api/v1/pools` | ✅ |
89
+ | Create Pool | `/api/v1/pools` | ✅ |
90
+ | Get Pool | `/api/v1/pools/{pool_name}` | ✅ |
91
+ | Update Pool | `/api/v1/pools/{pool_name}` | ✅ |
92
+ | Delete Pool | `/api/v1/pools/{pool_name}` | ✅ |
93
+ | **XComs** | | |
94
+ | List XComs | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/xcomEntries` | ✅ |
95
+ | Get XCom Entry | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/xcomEntries/{xcom_key}` | ✅ |
96
+ | **Datasets** | | |
97
+ | List Datasets | `/api/v1/datasets` | ✅ |
98
+ | Get Dataset | `/api/v1/datasets/{uri}` | ✅ |
99
+ | Get Dataset Events | `/api/v1/datasetEvents` | ✅ |
100
+ | Create Dataset Event | `/api/v1/datasetEvents` | ✅ |
101
+ | Get DAG Dataset Queued Event | `/api/v1/dags/{dag_id}/dagRuns/queued/datasetEvents/{uri}` | ✅ |
102
+ | Get DAG Dataset Queued Events | `/api/v1/dags/{dag_id}/dagRuns/queued/datasetEvents` | ✅ |
103
+ | Delete DAG Dataset Queued Event | `/api/v1/dags/{dag_id}/dagRuns/queued/datasetEvents/{uri}` | ✅ |
104
+ | Delete DAG Dataset Queued Events | `/api/v1/dags/{dag_id}/dagRuns/queued/datasetEvents` | ✅ |
105
+ | Get Dataset Queued Events | `/api/v1/datasets/{uri}/dagRuns/queued/datasetEvents` | ✅ |
106
+ | Delete Dataset Queued Events | `/api/v1/datasets/{uri}/dagRuns/queued/datasetEvents` | ✅ |
107
+ | **Monitoring** | | |
108
+ | Get Health | `/api/v1/health` | ✅ |
109
+ | **DAG Stats** | | |
110
+ | Get DAG Stats | `/api/v1/dags/statistics` | ✅ |
111
+ | **Config** | | |
112
+ | Get Config | `/api/v1/config` | ✅ |
113
+ | **Plugins** | | |
114
+ | Get Plugins | `/api/v1/plugins` | ✅ |
115
+ | **Providers** | | |
116
+ | List Providers | `/api/v1/providers` | ✅ |
117
+ | **Event Logs** | | |
118
+ | List Event Logs | `/api/v1/eventLogs` | ✅ |
119
+ | Get Event Log | `/api/v1/eventLogs/{event_log_id}` | ✅ |
120
+ | **System** | | |
121
+ | Get Import Errors | `/api/v1/importErrors` | ✅ |
122
+ | Get Import Error Details | `/api/v1/importErrors/{import_error_id}` | ✅ |
123
+ | Get Health Status | `/api/v1/health` | ✅ |
124
+ | Get Version | `/api/v1/version` | ✅ |
78
125
 
79
126
  ## Setup
80
127
 
@@ -136,6 +183,34 @@ Alternative configuration using `uv`:
136
183
 
137
184
  Replace `/path/to/mcp-server-apache-airflow` with the actual path where you've cloned the repository.
138
185
 
186
+ ### Selecting the API groups
187
+
188
+ You can select the API groups you want to use by setting the `--apis` flag.
189
+
190
+ ```bash
191
+ uv run mcp-server-apache-airflow --apis "dag,dagrun"
192
+ ```
193
+
194
+ The default is to use all APIs.
195
+
196
+ Allowed values are:
197
+
198
+ - config
199
+ - connections
200
+ - dag
201
+ - dagrun
202
+ - dagstats
203
+ - dataset
204
+ - eventlog
205
+ - importerror
206
+ - monitoring
207
+ - plugin
208
+ - pool
209
+ - provider
210
+ - taskinstance
211
+ - variable
212
+ - xcom
213
+
139
214
  ### Manual Execution
140
215
 
141
216
  You can also run the server manually:
@@ -2,6 +2,10 @@
2
2
 
3
3
  A Model Context Protocol (MCP) server implementation for Apache Airflow, enabling seamless integration with MCP clients. This project provides a standardized way to interact with Apache Airflow through the Model Context Protocol.
4
4
 
5
+ <a href="https://glama.ai/mcp/servers/e99b6vx9lw">
6
+ <img width="380" height="200" src="https://glama.ai/mcp/servers/e99b6vx9lw/badge" alt="Server for Apache Airflow MCP server" />
7
+ </a>
8
+
5
9
  ## About
6
10
 
7
11
  This project implements a [Model Context Protocol](https://modelcontextprotocol.io/introduction) server that wraps Apache Airflow's REST API, allowing MCP clients to interact with Airflow in a standardized way. It uses the official Apache Airflow client library to ensure compatibility and maintainability.
@@ -15,25 +19,29 @@ This project implements a [Model Context Protocol](https://modelcontextprotocol.
15
19
  | Get DAG Details | `/api/v1/dags/{dag_id}` | ✅ |
16
20
  | Pause DAG | `/api/v1/dags/{dag_id}` | ✅ |
17
21
  | Unpause DAG | `/api/v1/dags/{dag_id}` | ✅ |
18
- | Update DAG | `/api/v1/dags/{dag_id}` | ✅ | |
22
+ | Update DAG | `/api/v1/dags/{dag_id}` | ✅ |
19
23
  | Delete DAG | `/api/v1/dags/{dag_id}` | ✅ |
24
+ | Get DAG Source | `/api/v1/dagSources/{file_token}` | ✅ |
25
+ | Patch Multiple DAGs | `/api/v1/dags` | ✅ |
26
+ | Reparse DAG File | `/api/v1/dagSources/{file_token}/reparse` | ✅ |
20
27
  | **DAG Runs** | | |
21
28
  | List DAG Runs | `/api/v1/dags/{dag_id}/dagRuns` | ✅ |
22
29
  | Create DAG Run | `/api/v1/dags/{dag_id}/dagRuns` | ✅ |
23
30
  | Get DAG Run Details | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}` | ✅ |
24
31
  | Update DAG Run | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}` | ✅ |
25
32
  | Delete DAG Run | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}` | ✅ |
33
+ | Get DAG Runs Batch | `/api/v1/dags/~/dagRuns/list` | ✅ |
34
+ | Clear DAG Run | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/clear` | ✅ |
35
+ | Set DAG Run Note | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/setNote` | ✅ |
36
+ | Get Upstream Dataset Events | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/upstreamDatasetEvents` | ✅ |
26
37
  | **Tasks** | | |
27
38
  | List DAG Tasks | `/api/v1/dags/{dag_id}/tasks` | ✅ |
28
39
  | Get Task Details | `/api/v1/dags/{dag_id}/tasks/{task_id}` | ✅ |
29
40
  | Get Task Instance | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}` | ✅ |
30
41
  | List Task Instances | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances` | ✅ |
31
42
  | Update Task Instance | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}` | ✅ |
32
- | **System** | | |
33
- | Get Import Errors | `/api/v1/importErrors` | ✅ |
34
- | Get Import Error Details | `/api/v1/importErrors/{import_error_id}` | ✅ |
35
- | Get Health Status | `/api/v1/health` | ✅ |
36
- | Get Version | `/api/v1/version` | ✅ |
43
+ | Clear Task Instances | `/api/v1/dags/{dag_id}/clearTaskInstances` | ✅ |
44
+ | Set Task Instances State | `/api/v1/dags/{dag_id}/updateTaskInstancesState` | ✅ |
37
45
  | **Variables** | | |
38
46
  | List Variables | `/api/v1/variables` | ✅ |
39
47
  | Create Variable | `/api/v1/variables` | ✅ |
@@ -46,6 +54,45 @@ This project implements a [Model Context Protocol](https://modelcontextprotocol.
46
54
  | Get Connection | `/api/v1/connections/{connection_id}` | ✅ |
47
55
  | Update Connection | `/api/v1/connections/{connection_id}` | ✅ |
48
56
  | Delete Connection | `/api/v1/connections/{connection_id}` | ✅ |
57
+ | Test Connection | `/api/v1/connections/test` | ✅ |
58
+ | **Pools** | | |
59
+ | List Pools | `/api/v1/pools` | ✅ |
60
+ | Create Pool | `/api/v1/pools` | ✅ |
61
+ | Get Pool | `/api/v1/pools/{pool_name}` | ✅ |
62
+ | Update Pool | `/api/v1/pools/{pool_name}` | ✅ |
63
+ | Delete Pool | `/api/v1/pools/{pool_name}` | ✅ |
64
+ | **XComs** | | |
65
+ | List XComs | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/xcomEntries` | ✅ |
66
+ | Get XCom Entry | `/api/v1/dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/xcomEntries/{xcom_key}` | ✅ |
67
+ | **Datasets** | | |
68
+ | List Datasets | `/api/v1/datasets` | ✅ |
69
+ | Get Dataset | `/api/v1/datasets/{uri}` | ✅ |
70
+ | Get Dataset Events | `/api/v1/datasetEvents` | ✅ |
71
+ | Create Dataset Event | `/api/v1/datasetEvents` | ✅ |
72
+ | Get DAG Dataset Queued Event | `/api/v1/dags/{dag_id}/dagRuns/queued/datasetEvents/{uri}` | ✅ |
73
+ | Get DAG Dataset Queued Events | `/api/v1/dags/{dag_id}/dagRuns/queued/datasetEvents` | ✅ |
74
+ | Delete DAG Dataset Queued Event | `/api/v1/dags/{dag_id}/dagRuns/queued/datasetEvents/{uri}` | ✅ |
75
+ | Delete DAG Dataset Queued Events | `/api/v1/dags/{dag_id}/dagRuns/queued/datasetEvents` | ✅ |
76
+ | Get Dataset Queued Events | `/api/v1/datasets/{uri}/dagRuns/queued/datasetEvents` | ✅ |
77
+ | Delete Dataset Queued Events | `/api/v1/datasets/{uri}/dagRuns/queued/datasetEvents` | ✅ |
78
+ | **Monitoring** | | |
79
+ | Get Health | `/api/v1/health` | ✅ |
80
+ | **DAG Stats** | | |
81
+ | Get DAG Stats | `/api/v1/dags/statistics` | ✅ |
82
+ | **Config** | | |
83
+ | Get Config | `/api/v1/config` | ✅ |
84
+ | **Plugins** | | |
85
+ | Get Plugins | `/api/v1/plugins` | ✅ |
86
+ | **Providers** | | |
87
+ | List Providers | `/api/v1/providers` | ✅ |
88
+ | **Event Logs** | | |
89
+ | List Event Logs | `/api/v1/eventLogs` | ✅ |
90
+ | Get Event Log | `/api/v1/eventLogs/{event_log_id}` | ✅ |
91
+ | **System** | | |
92
+ | Get Import Errors | `/api/v1/importErrors` | ✅ |
93
+ | Get Import Error Details | `/api/v1/importErrors/{import_error_id}` | ✅ |
94
+ | Get Health Status | `/api/v1/health` | ✅ |
95
+ | Get Version | `/api/v1/version` | ✅ |
49
96
 
50
97
  ## Setup
51
98
 
@@ -107,6 +154,34 @@ Alternative configuration using `uv`:
107
154
 
108
155
  Replace `/path/to/mcp-server-apache-airflow` with the actual path where you've cloned the repository.
109
156
 
157
+ ### Selecting the API groups
158
+
159
+ You can select the API groups you want to use by setting the `--apis` flag.
160
+
161
+ ```bash
162
+ uv run mcp-server-apache-airflow --apis "dag,dagrun"
163
+ ```
164
+
165
+ The default is to use all APIs.
166
+
167
+ Allowed values are:
168
+
169
+ - config
170
+ - connections
171
+ - dag
172
+ - dagrun
173
+ - dagstats
174
+ - dataset
175
+ - eventlog
176
+ - importerror
177
+ - monitoring
178
+ - plugin
179
+ - pool
180
+ - provider
181
+ - taskinstance
182
+ - variable
183
+ - xcom
184
+
110
185
  ### Manual Execution
111
186
 
112
187
  You can also run the server manually:
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "mcp-server-apache-airflow"
3
- version = "0.2.1"
3
+ version = "0.2.2"
4
4
  description = "Model Context Protocol (MCP) server for Apache Airflow"
5
5
  authors = [
6
6
  { name = "Gyeongmo Yang", email = "me@gmyang.dev" }
@@ -42,7 +42,7 @@ requires = ["hatchling"]
42
42
  build-backend = "hatchling.build"
43
43
 
44
44
  [project.scripts]
45
- mcp-server-apache-airflow = "server:main"
45
+ mcp-server-apache-airflow = "src.main:main"
46
46
 
47
47
  [tool.hatch.build.targets.wheel]
48
48
  packages = ["src"]