mcp-trino-python 0.1.0__tar.gz → 0.3.0__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.
@@ -1,16 +1,16 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-trino-python
3
- Version: 0.1.0
3
+ Version: 0.3.0
4
4
  Summary: A Model Context Protocol (MCP) connector for Trino, enabling seamless integration between MCP-compliant services and Trino query engine
5
5
  License: Apache-2.0
6
6
  Keywords: trino,connector,mcp
7
- Classifier: Programming Language :: Python :: 3.11
7
+ Classifier: Programming Language :: Python :: 3.12
8
8
  Classifier: License :: OSI Approved :: Apache Software License
9
9
  Classifier: Operating System :: OS Independent
10
10
  Classifier: Development Status :: 4 - Beta
11
11
  Classifier: Intended Audience :: Developers
12
12
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
13
- Requires-Python: >=3.11
13
+ Requires-Python: >=3.12
14
14
  Description-Content-Type: text/markdown
15
15
  License-File: LICENSE
16
16
  Requires-Dist: loguru>=0.7.3
@@ -73,7 +73,11 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
73
73
  "env": {
74
74
  "TRINO_HOST": "${input:trino_host}",
75
75
  "TRINO_PORT": "${input:trino_port}",
76
- "TRINO_USER": "${input:trino_user}"
76
+ "TRINO_USER": "${input:trino_user}",
77
+ "TRINO_PASSWORD": "${input:trino_password}",
78
+ "TRINO_HTTP_SCHEME": "${input:trino_http_scheme}",
79
+ "TRINO_CATALOG": "${input:trino_catalog}",
80
+ "TRINO_SCHEMA": "${input:trino_schema}"
77
81
  }
78
82
  }
79
83
  }
@@ -90,7 +94,7 @@ Add the following configuration to your Claude Desktop settings:
90
94
  "mcpServers": {
91
95
  "trino": {
92
96
  "command": "python",
93
- "args": ["server.py"],
97
+ "args": ["./src/server.py"],
94
98
  "env": {
95
99
  "TRINO_HOST": "your-trino-host",
96
100
  "TRINO_PORT": "8080",
@@ -113,7 +117,7 @@ Add the following configuration to your Claude Desktop settings:
113
117
  | TRINO_CATALOG | Default catalog | None |
114
118
  | TRINO_SCHEMA | Default schema | None |
115
119
  | TRINO_HTTP_SCHEME | HTTP scheme (http/https) | http |
116
- | TRINO_AUTH | Authentication method | None |
120
+ | TRINO_PASSWORD | Trino password | None |
117
121
 
118
122
  ## Resources
119
123
 
@@ -121,18 +125,18 @@ The server provides the following MCP resources:
121
125
 
122
126
  ### Catalog and Schema Navigation
123
127
 
124
- - **catalog://main** (`list_catalogs`)
128
+ - **catalog://main** (`show_catalogs`)
125
129
 
126
130
  - Lists all available Trino catalogs
127
131
  - No parameters required
128
132
 
129
- - **schema://{catalog}** (`list_schemas`)
133
+ - **schema://{catalog}** (`show_schemas`)
130
134
 
131
135
  - Lists all schemas in the specified catalog
132
136
  - Parameters:
133
137
  - `catalog`: Catalog name (string, required)
134
138
 
135
- - **table://{catalog}/{schema}** (`list_tables`)
139
+ - **table://{catalog}/{schema}** (`show_tables`)
136
140
  - Lists all tables in the specified schema
137
141
  - Parameters:
138
142
  - `catalog`: Catalog name (string, required)
@@ -151,7 +155,7 @@ The server provides the following MCP resources:
151
155
  - **show_catalog_tree**
152
156
 
153
157
  - Show a hierarchical tree view of catalogs, schemas, and tables
154
- - Returns a formatted tree structure with visual indicators
158
+ - Returns a formatted tree structure with visual indicators
155
159
  - No parameters required
156
160
 
157
161
  - **show_create_table**
@@ -203,6 +207,90 @@ The server provides the following MCP resources:
203
207
  - `catalog`: Catalog name (string, optional)
204
208
  - `schema`: Schema name (string, optional)
205
209
 
210
+ ### Iceberg Metadata Inspection
211
+
212
+ - **show_table_properties**
213
+
214
+ - Show Iceberg table properties
215
+ - Parameters:
216
+ - `table`: Table name (string, required)
217
+ - `catalog`: Catalog name (string, optional)
218
+ - `schema`: Schema name (string, optional)
219
+
220
+ - **show_table_history**
221
+
222
+ - Show Iceberg table history/changelog
223
+ - Contains snapshot timing, lineage, and ancestry information
224
+ - Parameters:
225
+ - `table`: Table name (string, required)
226
+ - `catalog`: Catalog name (string, optional)
227
+ - `schema`: Schema name (string, optional)
228
+
229
+ - **show_metadata_log_entries**
230
+
231
+ - Show Iceberg table metadata log entries
232
+ - Contains metadata file locations and sequence information
233
+ - Parameters:
234
+ - `table`: Table name (string, required)
235
+ - `catalog`: Catalog name (string, optional)
236
+ - `schema`: Schema name (string, optional)
237
+
238
+ - **show_snapshots**
239
+
240
+ - Show Iceberg table snapshots
241
+ - Contains snapshot details including operations and manifest files
242
+ - Parameters:
243
+ - `table`: Table name (string, required)
244
+ - `catalog`: Catalog name (string, optional)
245
+ - `schema`: Schema name (string, optional)
246
+
247
+ - **show_manifests**
248
+
249
+ - Show Iceberg table manifests for current or all snapshots
250
+ - Contains manifest file details and data file statistics
251
+ - Parameters:
252
+ - `table`: Table name (string, required)
253
+ - `catalog`: Catalog name (string, optional)
254
+ - `schema`: Schema name (string, optional)
255
+ - `all_snapshots`: Include all snapshots (boolean, optional)
256
+
257
+ - **show_partitions**
258
+
259
+ - Show Iceberg table partitions
260
+ - Contains partition statistics and file counts
261
+ - Parameters:
262
+ - `table`: Table name (string, required)
263
+ - `catalog`: Catalog name (string, optional)
264
+ - `schema`: Schema name (string, optional)
265
+
266
+ - **show_files**
267
+
268
+ - Show Iceberg table data files in current snapshot
269
+ - Contains detailed file metadata and column statistics
270
+ - Parameters:
271
+ - `table`: Table name (string, required)
272
+ - `catalog`: Catalog name (string, optional)
273
+ - `schema`: Schema name (string, optional)
274
+
275
+ - **show_entries**
276
+
277
+ - Show Iceberg table manifest entries for current or all snapshots
278
+ - Contains entry status and detailed file metrics
279
+ - Parameters:
280
+ - `table`: Table name (string, required)
281
+ - `catalog`: Catalog name (string, optional)
282
+ - `schema`: Schema name (string, optional)
283
+ - `all_snapshots`: Include all snapshots (boolean, optional)
284
+
285
+ - **show_refs**
286
+
287
+ - Show Iceberg table references (branches and tags)
288
+ - Contains reference configuration and snapshot mapping
289
+ - Parameters:
290
+ - `table`: Table name (string, required)
291
+ - `catalog`: Catalog name (string, optional)
292
+ - `schema`: Schema name (string, optional)
293
+
206
294
  ### Query History
207
295
 
208
296
  - **show_query_history**
@@ -52,7 +52,11 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
52
52
  "env": {
53
53
  "TRINO_HOST": "${input:trino_host}",
54
54
  "TRINO_PORT": "${input:trino_port}",
55
- "TRINO_USER": "${input:trino_user}"
55
+ "TRINO_USER": "${input:trino_user}",
56
+ "TRINO_PASSWORD": "${input:trino_password}",
57
+ "TRINO_HTTP_SCHEME": "${input:trino_http_scheme}",
58
+ "TRINO_CATALOG": "${input:trino_catalog}",
59
+ "TRINO_SCHEMA": "${input:trino_schema}"
56
60
  }
57
61
  }
58
62
  }
@@ -69,7 +73,7 @@ Add the following configuration to your Claude Desktop settings:
69
73
  "mcpServers": {
70
74
  "trino": {
71
75
  "command": "python",
72
- "args": ["server.py"],
76
+ "args": ["./src/server.py"],
73
77
  "env": {
74
78
  "TRINO_HOST": "your-trino-host",
75
79
  "TRINO_PORT": "8080",
@@ -92,7 +96,7 @@ Add the following configuration to your Claude Desktop settings:
92
96
  | TRINO_CATALOG | Default catalog | None |
93
97
  | TRINO_SCHEMA | Default schema | None |
94
98
  | TRINO_HTTP_SCHEME | HTTP scheme (http/https) | http |
95
- | TRINO_AUTH | Authentication method | None |
99
+ | TRINO_PASSWORD | Trino password | None |
96
100
 
97
101
  ## Resources
98
102
 
@@ -100,18 +104,18 @@ The server provides the following MCP resources:
100
104
 
101
105
  ### Catalog and Schema Navigation
102
106
 
103
- - **catalog://main** (`list_catalogs`)
107
+ - **catalog://main** (`show_catalogs`)
104
108
 
105
109
  - Lists all available Trino catalogs
106
110
  - No parameters required
107
111
 
108
- - **schema://{catalog}** (`list_schemas`)
112
+ - **schema://{catalog}** (`show_schemas`)
109
113
 
110
114
  - Lists all schemas in the specified catalog
111
115
  - Parameters:
112
116
  - `catalog`: Catalog name (string, required)
113
117
 
114
- - **table://{catalog}/{schema}** (`list_tables`)
118
+ - **table://{catalog}/{schema}** (`show_tables`)
115
119
  - Lists all tables in the specified schema
116
120
  - Parameters:
117
121
  - `catalog`: Catalog name (string, required)
@@ -130,7 +134,7 @@ The server provides the following MCP resources:
130
134
  - **show_catalog_tree**
131
135
 
132
136
  - Show a hierarchical tree view of catalogs, schemas, and tables
133
- - Returns a formatted tree structure with visual indicators
137
+ - Returns a formatted tree structure with visual indicators
134
138
  - No parameters required
135
139
 
136
140
  - **show_create_table**
@@ -182,6 +186,90 @@ The server provides the following MCP resources:
182
186
  - `catalog`: Catalog name (string, optional)
183
187
  - `schema`: Schema name (string, optional)
184
188
 
189
+ ### Iceberg Metadata Inspection
190
+
191
+ - **show_table_properties**
192
+
193
+ - Show Iceberg table properties
194
+ - Parameters:
195
+ - `table`: Table name (string, required)
196
+ - `catalog`: Catalog name (string, optional)
197
+ - `schema`: Schema name (string, optional)
198
+
199
+ - **show_table_history**
200
+
201
+ - Show Iceberg table history/changelog
202
+ - Contains snapshot timing, lineage, and ancestry information
203
+ - Parameters:
204
+ - `table`: Table name (string, required)
205
+ - `catalog`: Catalog name (string, optional)
206
+ - `schema`: Schema name (string, optional)
207
+
208
+ - **show_metadata_log_entries**
209
+
210
+ - Show Iceberg table metadata log entries
211
+ - Contains metadata file locations and sequence information
212
+ - Parameters:
213
+ - `table`: Table name (string, required)
214
+ - `catalog`: Catalog name (string, optional)
215
+ - `schema`: Schema name (string, optional)
216
+
217
+ - **show_snapshots**
218
+
219
+ - Show Iceberg table snapshots
220
+ - Contains snapshot details including operations and manifest files
221
+ - Parameters:
222
+ - `table`: Table name (string, required)
223
+ - `catalog`: Catalog name (string, optional)
224
+ - `schema`: Schema name (string, optional)
225
+
226
+ - **show_manifests**
227
+
228
+ - Show Iceberg table manifests for current or all snapshots
229
+ - Contains manifest file details and data file statistics
230
+ - Parameters:
231
+ - `table`: Table name (string, required)
232
+ - `catalog`: Catalog name (string, optional)
233
+ - `schema`: Schema name (string, optional)
234
+ - `all_snapshots`: Include all snapshots (boolean, optional)
235
+
236
+ - **show_partitions**
237
+
238
+ - Show Iceberg table partitions
239
+ - Contains partition statistics and file counts
240
+ - Parameters:
241
+ - `table`: Table name (string, required)
242
+ - `catalog`: Catalog name (string, optional)
243
+ - `schema`: Schema name (string, optional)
244
+
245
+ - **show_files**
246
+
247
+ - Show Iceberg table data files in current snapshot
248
+ - Contains detailed file metadata and column statistics
249
+ - Parameters:
250
+ - `table`: Table name (string, required)
251
+ - `catalog`: Catalog name (string, optional)
252
+ - `schema`: Schema name (string, optional)
253
+
254
+ - **show_entries**
255
+
256
+ - Show Iceberg table manifest entries for current or all snapshots
257
+ - Contains entry status and detailed file metrics
258
+ - Parameters:
259
+ - `table`: Table name (string, required)
260
+ - `catalog`: Catalog name (string, optional)
261
+ - `schema`: Schema name (string, optional)
262
+ - `all_snapshots`: Include all snapshots (boolean, optional)
263
+
264
+ - **show_refs**
265
+
266
+ - Show Iceberg table references (branches and tags)
267
+ - Contains reference configuration and snapshot mapping
268
+ - Parameters:
269
+ - `table`: Table name (string, required)
270
+ - `catalog`: Catalog name (string, optional)
271
+ - `schema`: Schema name (string, optional)
272
+
185
273
  ### Query History
186
274
 
187
275
  - **show_query_history**
@@ -1,10 +1,10 @@
1
1
  [project]
2
2
  name = "mcp-trino-python"
3
- version = "0.1.0"
3
+ version = "0.3.0"
4
4
  description = "A Model Context Protocol (MCP) connector for Trino, enabling seamless integration between MCP-compliant services and Trino query engine"
5
5
  readme = "README.md"
6
6
  license = { text = "Apache-2.0" }
7
- requires-python = ">=3.11"
7
+ requires-python = ">=3.12"
8
8
  keywords = ["trino", "connector", "mcp"]
9
9
  dependencies = [
10
10
  "loguru>=0.7.3",
@@ -14,7 +14,7 @@ dependencies = [
14
14
  ]
15
15
 
16
16
  classifiers = [
17
- "Programming Language :: Python :: 3.11",
17
+ "Programming Language :: Python :: 3.12",
18
18
  "License :: OSI Approved :: Apache Software License",
19
19
  "Operating System :: OS Independent",
20
20
  "Development Status :: 4 - Beta",
@@ -23,6 +23,6 @@ classifiers = [
23
23
  ]
24
24
 
25
25
  [tool.black]
26
- target-version = ["py311"]
26
+ target-version = ["py312"]
27
27
  line-length = 120
28
28
  skip-string-normalization = true
@@ -17,7 +17,7 @@ class TrinoConfig:
17
17
  catalog: str | None = None
18
18
  schema: str | None = None
19
19
  http_scheme: str = "http"
20
- auth: str | None = None
20
+ auth: trino.auth.BasicAuthentication | None = None
21
21
  source: str = "mcp-trino-python"
22
22
 
23
23
 
@@ -1,16 +1,16 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-trino-python
3
- Version: 0.1.0
3
+ Version: 0.3.0
4
4
  Summary: A Model Context Protocol (MCP) connector for Trino, enabling seamless integration between MCP-compliant services and Trino query engine
5
5
  License: Apache-2.0
6
6
  Keywords: trino,connector,mcp
7
- Classifier: Programming Language :: Python :: 3.11
7
+ Classifier: Programming Language :: Python :: 3.12
8
8
  Classifier: License :: OSI Approved :: Apache Software License
9
9
  Classifier: Operating System :: OS Independent
10
10
  Classifier: Development Status :: 4 - Beta
11
11
  Classifier: Intended Audience :: Developers
12
12
  Classifier: Topic :: Software Development :: Libraries :: Python Modules
13
- Requires-Python: >=3.11
13
+ Requires-Python: >=3.12
14
14
  Description-Content-Type: text/markdown
15
15
  License-File: LICENSE
16
16
  Requires-Dist: loguru>=0.7.3
@@ -73,7 +73,11 @@ Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace
73
73
  "env": {
74
74
  "TRINO_HOST": "${input:trino_host}",
75
75
  "TRINO_PORT": "${input:trino_port}",
76
- "TRINO_USER": "${input:trino_user}"
76
+ "TRINO_USER": "${input:trino_user}",
77
+ "TRINO_PASSWORD": "${input:trino_password}",
78
+ "TRINO_HTTP_SCHEME": "${input:trino_http_scheme}",
79
+ "TRINO_CATALOG": "${input:trino_catalog}",
80
+ "TRINO_SCHEMA": "${input:trino_schema}"
77
81
  }
78
82
  }
79
83
  }
@@ -90,7 +94,7 @@ Add the following configuration to your Claude Desktop settings:
90
94
  "mcpServers": {
91
95
  "trino": {
92
96
  "command": "python",
93
- "args": ["server.py"],
97
+ "args": ["./src/server.py"],
94
98
  "env": {
95
99
  "TRINO_HOST": "your-trino-host",
96
100
  "TRINO_PORT": "8080",
@@ -113,7 +117,7 @@ Add the following configuration to your Claude Desktop settings:
113
117
  | TRINO_CATALOG | Default catalog | None |
114
118
  | TRINO_SCHEMA | Default schema | None |
115
119
  | TRINO_HTTP_SCHEME | HTTP scheme (http/https) | http |
116
- | TRINO_AUTH | Authentication method | None |
120
+ | TRINO_PASSWORD | Trino password | None |
117
121
 
118
122
  ## Resources
119
123
 
@@ -121,18 +125,18 @@ The server provides the following MCP resources:
121
125
 
122
126
  ### Catalog and Schema Navigation
123
127
 
124
- - **catalog://main** (`list_catalogs`)
128
+ - **catalog://main** (`show_catalogs`)
125
129
 
126
130
  - Lists all available Trino catalogs
127
131
  - No parameters required
128
132
 
129
- - **schema://{catalog}** (`list_schemas`)
133
+ - **schema://{catalog}** (`show_schemas`)
130
134
 
131
135
  - Lists all schemas in the specified catalog
132
136
  - Parameters:
133
137
  - `catalog`: Catalog name (string, required)
134
138
 
135
- - **table://{catalog}/{schema}** (`list_tables`)
139
+ - **table://{catalog}/{schema}** (`show_tables`)
136
140
  - Lists all tables in the specified schema
137
141
  - Parameters:
138
142
  - `catalog`: Catalog name (string, required)
@@ -151,7 +155,7 @@ The server provides the following MCP resources:
151
155
  - **show_catalog_tree**
152
156
 
153
157
  - Show a hierarchical tree view of catalogs, schemas, and tables
154
- - Returns a formatted tree structure with visual indicators
158
+ - Returns a formatted tree structure with visual indicators
155
159
  - No parameters required
156
160
 
157
161
  - **show_create_table**
@@ -203,6 +207,90 @@ The server provides the following MCP resources:
203
207
  - `catalog`: Catalog name (string, optional)
204
208
  - `schema`: Schema name (string, optional)
205
209
 
210
+ ### Iceberg Metadata Inspection
211
+
212
+ - **show_table_properties**
213
+
214
+ - Show Iceberg table properties
215
+ - Parameters:
216
+ - `table`: Table name (string, required)
217
+ - `catalog`: Catalog name (string, optional)
218
+ - `schema`: Schema name (string, optional)
219
+
220
+ - **show_table_history**
221
+
222
+ - Show Iceberg table history/changelog
223
+ - Contains snapshot timing, lineage, and ancestry information
224
+ - Parameters:
225
+ - `table`: Table name (string, required)
226
+ - `catalog`: Catalog name (string, optional)
227
+ - `schema`: Schema name (string, optional)
228
+
229
+ - **show_metadata_log_entries**
230
+
231
+ - Show Iceberg table metadata log entries
232
+ - Contains metadata file locations and sequence information
233
+ - Parameters:
234
+ - `table`: Table name (string, required)
235
+ - `catalog`: Catalog name (string, optional)
236
+ - `schema`: Schema name (string, optional)
237
+
238
+ - **show_snapshots**
239
+
240
+ - Show Iceberg table snapshots
241
+ - Contains snapshot details including operations and manifest files
242
+ - Parameters:
243
+ - `table`: Table name (string, required)
244
+ - `catalog`: Catalog name (string, optional)
245
+ - `schema`: Schema name (string, optional)
246
+
247
+ - **show_manifests**
248
+
249
+ - Show Iceberg table manifests for current or all snapshots
250
+ - Contains manifest file details and data file statistics
251
+ - Parameters:
252
+ - `table`: Table name (string, required)
253
+ - `catalog`: Catalog name (string, optional)
254
+ - `schema`: Schema name (string, optional)
255
+ - `all_snapshots`: Include all snapshots (boolean, optional)
256
+
257
+ - **show_partitions**
258
+
259
+ - Show Iceberg table partitions
260
+ - Contains partition statistics and file counts
261
+ - Parameters:
262
+ - `table`: Table name (string, required)
263
+ - `catalog`: Catalog name (string, optional)
264
+ - `schema`: Schema name (string, optional)
265
+
266
+ - **show_files**
267
+
268
+ - Show Iceberg table data files in current snapshot
269
+ - Contains detailed file metadata and column statistics
270
+ - Parameters:
271
+ - `table`: Table name (string, required)
272
+ - `catalog`: Catalog name (string, optional)
273
+ - `schema`: Schema name (string, optional)
274
+
275
+ - **show_entries**
276
+
277
+ - Show Iceberg table manifest entries for current or all snapshots
278
+ - Contains entry status and detailed file metrics
279
+ - Parameters:
280
+ - `table`: Table name (string, required)
281
+ - `catalog`: Catalog name (string, optional)
282
+ - `schema`: Schema name (string, optional)
283
+ - `all_snapshots`: Include all snapshots (boolean, optional)
284
+
285
+ - **show_refs**
286
+
287
+ - Show Iceberg table references (branches and tags)
288
+ - Contains reference configuration and snapshot mapping
289
+ - Parameters:
290
+ - `table`: Table name (string, required)
291
+ - `catalog`: Catalog name (string, optional)
292
+ - `schema`: Schema name (string, optional)
293
+
206
294
  ### Query History
207
295
 
208
296
  - **show_query_history**