MCP Iceberg Catalog
MCP 氷山カタログ
Apache Icebergと連携するためのMCP(Model Context Protocol)サーバー実装。このサーバーは、ClaudeデスクトップからIcebergテーブルをクエリおよび管理するためのSQLインターフェースを提供します。
Claude Desktop を Iceberg Data Lake カタログとして

Related MCP server: Databricks MCP Server
Claude Desktopへのインストール方法
Smithery経由でインストール
Smithery経由で Claude Desktop 用の MCP Iceberg Catalog を自動的にインストールするには:
npx -y @smithery/cli install @ahodroj/mcp-iceberg-service --client claude前提条件
Python 3.10以上
UV パッケージインストーラー(推奨)または pip
Iceberg RESTカタログとS3互換ストレージへのアクセス
Claude Desktop にインストールする方法
claude_desktop_config.jsonに次の構成を追加します。
{
"mcpServers": {
"iceberg": {
"command": "uv",
"args": [
"--directory",
"PATH_TO_/mcp-iceberg-service",
"run",
"mcp-server-iceberg"
],
"env": {
"ICEBERG_CATALOG_URI" : "http://localhost:8181",
"ICEBERG_WAREHOUSE" : "YOUR ICEBERG WAREHOUSE NAME",
"S3_ENDPOINT" : "OPTIONAL IF USING S3",
"AWS_ACCESS_KEY_ID" : "YOUR S3 ACCESS KEY",
"AWS_SECRET_ACCESS_KEY" : "YOUR S3 SECRET KEY"
}
}
}
}デザイン
建築
MCP サーバーは、次の 3 つの主要コンポーネントに基づいて構築されます。
MCP プロトコル ハンドラー
クロードとの通信のためのモデルコンテキストプロトコルを実装します
stdio を通じてリクエスト/レスポンスのサイクルを処理します
サーバーのライフサイクルと初期化を管理します
クエリプロセッサ
sqlparseを使用して SQL クエリを解析しますサポートされる操作:
リストテーブル
表の説明
選択
入れる
氷山統合
テーブル操作には
pyiceberg使用するPyArrowと統合して効率的なデータ処理を実現
カタログ接続とテーブル操作を管理します
PyIceberg 統合
サーバーは PyIceberg をいくつかの方法で利用します。
カタログ管理
RESTカタログに接続する
テーブルメタデータを管理する
名前空間の操作を処理する
データ操作
PyIceberg型とPyArrow型間の変換
PyArrow テーブルを通じてデータ挿入を処理します
テーブルスキーマとフィールドタイプを管理します
クエリ実行
SQLをPyIcebergの操作に変換する
データのスキャンとフィルタリングを処理
結果セットの変換を管理する
さらなる実装が必要
クエリ操作
[ ] UPDATE操作を実装する
[ ] DELETEサポートを追加
[ ] スキーマ定義付きのCREATE TABLEのサポート
[ ] ALTER TABLE操作を追加する
[ ] テーブルパーティションサポートを実装する
データ型
[ ] 複合型(配列、マップ、構造体)のサポート
[ ] タイムゾーン処理付きのタイムスタンプを追加する
[ ] 小数点型のサポート
[ ] ネストされたフィールドのサポートを追加
パフォーマンスの改善
[ ] バッチ挿入を実装する
[ ] クエリ最適化を追加する
[ ] 並列スキャンのサポート
[ ] 頻繁にアクセスされるデータにキャッシュ層を追加する
セキュリティ機能
[ ] 認証メカニズムを追加する
[ ] ロールベースのアクセス制御を実装する
[ ] 行レベルのセキュリティを追加する
[ ] 暗号化された接続のサポート
監視と管理
[ ] メトリクスコレクションを追加する
[ ] クエリログの実装
[ ] パフォーマンス監視を追加する
[ ] テーブルメンテナンス操作のサポート
エラー処理
[ ] エラーメッセージの改善
[ ] 一時的な障害に対する再試行メカニズムを追加する
[ ] トランザクションサポートを実装する
[ ] データ検証を追加する
Available Tools
1 toolexecute_queryC
Execute a query on Iceberg tables
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to confuse it with. The tool's purpose is clearly defined and distinct by default.
Since there is only one tool, naming consistency is inherently perfect with no deviations or mixed conventions to evaluate. The tool name follows a clear verb_noun pattern (execute_query).
A single tool is too few for a catalog server, which typically requires operations like list_tables, get_table, create_table, or update_metadata to be useful. This minimal set severely limits functionality and scope.
The tool set is severely incomplete for an Iceberg catalog domain, lacking basic CRUD operations such as listing, creating, or managing tables. With only a query execution tool, agents cannot perform essential catalog tasks, leading to dead ends.
Related MCP Connectors
The BigQuery remote MCP server is a fully managed service that uses the Model Context Protocol to connect AI applications and LLMs to BigQuery data sources. It provides secure, standardized tools for AI agents to list datasets and tables, retrieve schemas, generate and execute SQL queries through natural language, and analyze data—enabling direct access to enterprise analytics data without requiring manual SQL coding.
Query your warehouse or a CSV with Claude/ChatGPT over MCP, governed by table-level ACL + audit.
Hosted BigQuery MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted SQL Server MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables Claude to execute SQL queries on Snowflake databases with automatic connection lifecycle management.45MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables LLMs to interact with Databricks workspaces through natural language, allowing SQL query execution and job management operations.50-
- AlicenseCqualityDmaintenanceAn MCP server that enables natural language interaction with Apache Iceberg data lakehouses, allowing users to query table metadata, schemas, and properties through Claude, Cursor, or other MCP clients.541Apache 2.0
- AlicenseBqualityCmaintenanceA Model Context Protocol server that provides seamless integration with Trino and Iceberg, enabling data exploration, querying, and table maintenance through a standard interface.2225Apache 2.0