mcp-trino-python 0.2.0__tar.gz → 0.4.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,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-trino-python
3
- Version: 0.2.0
3
+ Version: 0.4.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
@@ -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
 
@@ -142,6 +146,32 @@ The server provides the following MCP resources:
142
146
 
143
147
  ### Query and Exploration Tools
144
148
 
149
+ - **show_catalogs**
150
+
151
+ - List all available catalogs
152
+ - No parameters required
153
+
154
+ - **show_schemas**
155
+
156
+ - List all schemas in a catalog
157
+ - Parameters:
158
+ - `catalog`: Catalog name (string, required)
159
+
160
+ - **show_tables**
161
+
162
+ - List all tables in a schema
163
+ - Parameters:
164
+ - `catalog`: Catalog name (string, required)
165
+ - `schema`: Schema name (string, required)
166
+
167
+ - **describe_table**
168
+
169
+ - Show detailed table structure and column information
170
+ - Parameters:
171
+ - `table`: Table name (string, required)
172
+ - `catalog`: Catalog name (string, optional)
173
+ - `schema`: Schema name (string, optional)
174
+
145
175
  - **execute_query**
146
176
 
147
177
  - Execute a SQL query and return formatted results
@@ -151,7 +181,7 @@ The server provides the following MCP resources:
151
181
  - **show_catalog_tree**
152
182
 
153
183
  - Show a hierarchical tree view of catalogs, schemas, and tables
154
- - Returns a formatted tree structure with visual indicators
184
+ - Returns a formatted tree structure with visual indicators
155
185
  - No parameters required
156
186
 
157
187
  - **show_create_table**
@@ -203,6 +233,90 @@ The server provides the following MCP resources:
203
233
  - `catalog`: Catalog name (string, optional)
204
234
  - `schema`: Schema name (string, optional)
205
235
 
236
+ ### Iceberg Metadata Inspection
237
+
238
+ - **show_table_properties**
239
+
240
+ - Show Iceberg table properties
241
+ - Parameters:
242
+ - `table`: Table name (string, required)
243
+ - `catalog`: Catalog name (string, optional)
244
+ - `schema`: Schema name (string, optional)
245
+
246
+ - **show_table_history**
247
+
248
+ - Show Iceberg table history/changelog
249
+ - Contains snapshot timing, lineage, and ancestry information
250
+ - Parameters:
251
+ - `table`: Table name (string, required)
252
+ - `catalog`: Catalog name (string, optional)
253
+ - `schema`: Schema name (string, optional)
254
+
255
+ - **show_metadata_log_entries**
256
+
257
+ - Show Iceberg table metadata log entries
258
+ - Contains metadata file locations and sequence information
259
+ - Parameters:
260
+ - `table`: Table name (string, required)
261
+ - `catalog`: Catalog name (string, optional)
262
+ - `schema`: Schema name (string, optional)
263
+
264
+ - **show_snapshots**
265
+
266
+ - Show Iceberg table snapshots
267
+ - Contains snapshot details including operations and manifest files
268
+ - Parameters:
269
+ - `table`: Table name (string, required)
270
+ - `catalog`: Catalog name (string, optional)
271
+ - `schema`: Schema name (string, optional)
272
+
273
+ - **show_manifests**
274
+
275
+ - Show Iceberg table manifests for current or all snapshots
276
+ - Contains manifest file details and data file statistics
277
+ - Parameters:
278
+ - `table`: Table name (string, required)
279
+ - `catalog`: Catalog name (string, optional)
280
+ - `schema`: Schema name (string, optional)
281
+ - `all_snapshots`: Include all snapshots (boolean, optional)
282
+
283
+ - **show_partitions**
284
+
285
+ - Show Iceberg table partitions
286
+ - Contains partition statistics and file counts
287
+ - Parameters:
288
+ - `table`: Table name (string, required)
289
+ - `catalog`: Catalog name (string, optional)
290
+ - `schema`: Schema name (string, optional)
291
+
292
+ - **show_files**
293
+
294
+ - Show Iceberg table data files in current snapshot
295
+ - Contains detailed file metadata and column statistics
296
+ - Parameters:
297
+ - `table`: Table name (string, required)
298
+ - `catalog`: Catalog name (string, optional)
299
+ - `schema`: Schema name (string, optional)
300
+
301
+ - **show_entries**
302
+
303
+ - Show Iceberg table manifest entries for current or all snapshots
304
+ - Contains entry status and detailed file metrics
305
+ - Parameters:
306
+ - `table`: Table name (string, required)
307
+ - `catalog`: Catalog name (string, optional)
308
+ - `schema`: Schema name (string, optional)
309
+ - `all_snapshots`: Include all snapshots (boolean, optional)
310
+
311
+ - **show_refs**
312
+
313
+ - Show Iceberg table references (branches and tags)
314
+ - Contains reference configuration and snapshot mapping
315
+ - Parameters:
316
+ - `table`: Table name (string, required)
317
+ - `catalog`: Catalog name (string, optional)
318
+ - `schema`: Schema name (string, optional)
319
+
206
320
  ### Query History
207
321
 
208
322
  - **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
 
@@ -121,6 +125,32 @@ The server provides the following MCP resources:
121
125
 
122
126
  ### Query and Exploration Tools
123
127
 
128
+ - **show_catalogs**
129
+
130
+ - List all available catalogs
131
+ - No parameters required
132
+
133
+ - **show_schemas**
134
+
135
+ - List all schemas in a catalog
136
+ - Parameters:
137
+ - `catalog`: Catalog name (string, required)
138
+
139
+ - **show_tables**
140
+
141
+ - List all tables in a schema
142
+ - Parameters:
143
+ - `catalog`: Catalog name (string, required)
144
+ - `schema`: Schema name (string, required)
145
+
146
+ - **describe_table**
147
+
148
+ - Show detailed table structure and column information
149
+ - Parameters:
150
+ - `table`: Table name (string, required)
151
+ - `catalog`: Catalog name (string, optional)
152
+ - `schema`: Schema name (string, optional)
153
+
124
154
  - **execute_query**
125
155
 
126
156
  - Execute a SQL query and return formatted results
@@ -130,7 +160,7 @@ The server provides the following MCP resources:
130
160
  - **show_catalog_tree**
131
161
 
132
162
  - Show a hierarchical tree view of catalogs, schemas, and tables
133
- - Returns a formatted tree structure with visual indicators
163
+ - Returns a formatted tree structure with visual indicators
134
164
  - No parameters required
135
165
 
136
166
  - **show_create_table**
@@ -182,6 +212,90 @@ The server provides the following MCP resources:
182
212
  - `catalog`: Catalog name (string, optional)
183
213
  - `schema`: Schema name (string, optional)
184
214
 
215
+ ### Iceberg Metadata Inspection
216
+
217
+ - **show_table_properties**
218
+
219
+ - Show Iceberg table properties
220
+ - Parameters:
221
+ - `table`: Table name (string, required)
222
+ - `catalog`: Catalog name (string, optional)
223
+ - `schema`: Schema name (string, optional)
224
+
225
+ - **show_table_history**
226
+
227
+ - Show Iceberg table history/changelog
228
+ - Contains snapshot timing, lineage, and ancestry information
229
+ - Parameters:
230
+ - `table`: Table name (string, required)
231
+ - `catalog`: Catalog name (string, optional)
232
+ - `schema`: Schema name (string, optional)
233
+
234
+ - **show_metadata_log_entries**
235
+
236
+ - Show Iceberg table metadata log entries
237
+ - Contains metadata file locations and sequence information
238
+ - Parameters:
239
+ - `table`: Table name (string, required)
240
+ - `catalog`: Catalog name (string, optional)
241
+ - `schema`: Schema name (string, optional)
242
+
243
+ - **show_snapshots**
244
+
245
+ - Show Iceberg table snapshots
246
+ - Contains snapshot details including operations and manifest files
247
+ - Parameters:
248
+ - `table`: Table name (string, required)
249
+ - `catalog`: Catalog name (string, optional)
250
+ - `schema`: Schema name (string, optional)
251
+
252
+ - **show_manifests**
253
+
254
+ - Show Iceberg table manifests for current or all snapshots
255
+ - Contains manifest file details and data file statistics
256
+ - Parameters:
257
+ - `table`: Table name (string, required)
258
+ - `catalog`: Catalog name (string, optional)
259
+ - `schema`: Schema name (string, optional)
260
+ - `all_snapshots`: Include all snapshots (boolean, optional)
261
+
262
+ - **show_partitions**
263
+
264
+ - Show Iceberg table partitions
265
+ - Contains partition statistics and file counts
266
+ - Parameters:
267
+ - `table`: Table name (string, required)
268
+ - `catalog`: Catalog name (string, optional)
269
+ - `schema`: Schema name (string, optional)
270
+
271
+ - **show_files**
272
+
273
+ - Show Iceberg table data files in current snapshot
274
+ - Contains detailed file metadata and column statistics
275
+ - Parameters:
276
+ - `table`: Table name (string, required)
277
+ - `catalog`: Catalog name (string, optional)
278
+ - `schema`: Schema name (string, optional)
279
+
280
+ - **show_entries**
281
+
282
+ - Show Iceberg table manifest entries for current or all snapshots
283
+ - Contains entry status and detailed file metrics
284
+ - Parameters:
285
+ - `table`: Table name (string, required)
286
+ - `catalog`: Catalog name (string, optional)
287
+ - `schema`: Schema name (string, optional)
288
+ - `all_snapshots`: Include all snapshots (boolean, optional)
289
+
290
+ - **show_refs**
291
+
292
+ - Show Iceberg table references (branches and tags)
293
+ - Contains reference configuration and snapshot mapping
294
+ - Parameters:
295
+ - `table`: Table name (string, required)
296
+ - `catalog`: Catalog name (string, optional)
297
+ - `schema`: Schema name (string, optional)
298
+
185
299
  ### Query History
186
300
 
187
301
  - **show_query_history**
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "mcp-trino-python"
3
- version = "0.2.0"
3
+ version = "0.4.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" }
@@ -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,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-trino-python
3
- Version: 0.2.0
3
+ Version: 0.4.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
@@ -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
 
@@ -142,6 +146,32 @@ The server provides the following MCP resources:
142
146
 
143
147
  ### Query and Exploration Tools
144
148
 
149
+ - **show_catalogs**
150
+
151
+ - List all available catalogs
152
+ - No parameters required
153
+
154
+ - **show_schemas**
155
+
156
+ - List all schemas in a catalog
157
+ - Parameters:
158
+ - `catalog`: Catalog name (string, required)
159
+
160
+ - **show_tables**
161
+
162
+ - List all tables in a schema
163
+ - Parameters:
164
+ - `catalog`: Catalog name (string, required)
165
+ - `schema`: Schema name (string, required)
166
+
167
+ - **describe_table**
168
+
169
+ - Show detailed table structure and column information
170
+ - Parameters:
171
+ - `table`: Table name (string, required)
172
+ - `catalog`: Catalog name (string, optional)
173
+ - `schema`: Schema name (string, optional)
174
+
145
175
  - **execute_query**
146
176
 
147
177
  - Execute a SQL query and return formatted results
@@ -151,7 +181,7 @@ The server provides the following MCP resources:
151
181
  - **show_catalog_tree**
152
182
 
153
183
  - Show a hierarchical tree view of catalogs, schemas, and tables
154
- - Returns a formatted tree structure with visual indicators
184
+ - Returns a formatted tree structure with visual indicators
155
185
  - No parameters required
156
186
 
157
187
  - **show_create_table**
@@ -203,6 +233,90 @@ The server provides the following MCP resources:
203
233
  - `catalog`: Catalog name (string, optional)
204
234
  - `schema`: Schema name (string, optional)
205
235
 
236
+ ### Iceberg Metadata Inspection
237
+
238
+ - **show_table_properties**
239
+
240
+ - Show Iceberg table properties
241
+ - Parameters:
242
+ - `table`: Table name (string, required)
243
+ - `catalog`: Catalog name (string, optional)
244
+ - `schema`: Schema name (string, optional)
245
+
246
+ - **show_table_history**
247
+
248
+ - Show Iceberg table history/changelog
249
+ - Contains snapshot timing, lineage, and ancestry information
250
+ - Parameters:
251
+ - `table`: Table name (string, required)
252
+ - `catalog`: Catalog name (string, optional)
253
+ - `schema`: Schema name (string, optional)
254
+
255
+ - **show_metadata_log_entries**
256
+
257
+ - Show Iceberg table metadata log entries
258
+ - Contains metadata file locations and sequence information
259
+ - Parameters:
260
+ - `table`: Table name (string, required)
261
+ - `catalog`: Catalog name (string, optional)
262
+ - `schema`: Schema name (string, optional)
263
+
264
+ - **show_snapshots**
265
+
266
+ - Show Iceberg table snapshots
267
+ - Contains snapshot details including operations and manifest files
268
+ - Parameters:
269
+ - `table`: Table name (string, required)
270
+ - `catalog`: Catalog name (string, optional)
271
+ - `schema`: Schema name (string, optional)
272
+
273
+ - **show_manifests**
274
+
275
+ - Show Iceberg table manifests for current or all snapshots
276
+ - Contains manifest file details and data file statistics
277
+ - Parameters:
278
+ - `table`: Table name (string, required)
279
+ - `catalog`: Catalog name (string, optional)
280
+ - `schema`: Schema name (string, optional)
281
+ - `all_snapshots`: Include all snapshots (boolean, optional)
282
+
283
+ - **show_partitions**
284
+
285
+ - Show Iceberg table partitions
286
+ - Contains partition statistics and file counts
287
+ - Parameters:
288
+ - `table`: Table name (string, required)
289
+ - `catalog`: Catalog name (string, optional)
290
+ - `schema`: Schema name (string, optional)
291
+
292
+ - **show_files**
293
+
294
+ - Show Iceberg table data files in current snapshot
295
+ - Contains detailed file metadata and column statistics
296
+ - Parameters:
297
+ - `table`: Table name (string, required)
298
+ - `catalog`: Catalog name (string, optional)
299
+ - `schema`: Schema name (string, optional)
300
+
301
+ - **show_entries**
302
+
303
+ - Show Iceberg table manifest entries for current or all snapshots
304
+ - Contains entry status and detailed file metrics
305
+ - Parameters:
306
+ - `table`: Table name (string, required)
307
+ - `catalog`: Catalog name (string, optional)
308
+ - `schema`: Schema name (string, optional)
309
+ - `all_snapshots`: Include all snapshots (boolean, optional)
310
+
311
+ - **show_refs**
312
+
313
+ - Show Iceberg table references (branches and tags)
314
+ - Contains reference configuration and snapshot mapping
315
+ - Parameters:
316
+ - `table`: Table name (string, required)
317
+ - `catalog`: Catalog name (string, optional)
318
+ - `schema`: Schema name (string, optional)
319
+
206
320
  ### Query History
207
321
 
208
322
  - **show_query_history**