iceberg-mcp-server

Name: iceberg-mcp-server
Availability: InStock
Author: Cloudera

Cloudera Iceberg MCP Serverは、Apache Impalaを介してIcebergテーブルへの読み取り専用アクセスを提供するModel Context Protocolサーバーです。このサーバーは、LLM（大規模言語モデル）がデータベーススキーマを検査し、読み取り専用クエリを実行できるようにします。主にデータベースやファイルシステム、AI/LLM、クラウド環境での利用が想定されています。

GitHub

GitHubスター

ユーザー評価

未評価

お気に入り

閲覧数

フォーク

イシュー

インストール方法

難易度

中級

推定所要時間

10-20 分

必要な環境

Python 3.6以上

Apache Impala 最新版

インストール方法

前提条件

必要なソフトウェアとバージョンは以下の通りです。

Python: 3.6以上

Apache Impala: 最新版

インストール手順

1. リポジトリのクローン

bash
git clone https://github.com/cloudera/iceberg-mcp-server.git
cd iceberg-mcp-server

2. 依存関係のインストール

bash
pip install -r requirements.txt

3. Claude Desktop設定

claude_desktop_config.jsonを編集してMCPサーバーを追加：

json
{
  "mcpServers": {
    "iceberg-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/cloudera/iceberg-mcp-server@main",
        "run-server"
      ],
      "env": {
        "IMPALA_HOST": "coordinator-default-impala.example.com",
        "IMPALA_PORT": "443",
        "IMPALA_USER": "username",
        "IMPALA_PASSWORD": "password",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

4. サーバーの起動

bash
uvx run-server

トラブルシューティング

よくある問題

問題: サーバーが起動しない 解決策: Pythonのバージョンと依存関係を確認してください。問題: Claude Desktopで認識されない 解決策: 設定ファイルのパスと構文を確認してください。

設定方法

基本設定

Claude Desktop設定

~/.config/claude-desktop/claude_desktop_config.json（macOS/Linux）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集：

json
{
  "mcpServers": {
    "iceberg-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/cloudera/iceberg-mcp-server@main",
        "run-server"
      ],
      "env": {
        "IMPALA_HOST": "coordinator-default-impala.example.com",
        "IMPALA_PORT": "443",
        "IMPALA_USER": "username",
        "IMPALA_PASSWORD": "password",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

環境変数

必要に応じて以下の環境変数を設定：

bash
export IMPALA_HOST="coordinator-default-impala.example.com"
export IMPALA_PORT="443"
export IMPALA_USER="username"
export IMPALA_PASSWORD="password"
export IMPALA_DATABASE="default"

詳細設定

セキュリティ設定

環境変数に機密情報を保存

アクセス権限の適切な設定

パフォーマンス調整

タイムアウト値の設定

設定例

json
{
  "mcpServers": {
    "iceberg-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/cloudera/iceberg-mcp-server@main",
        "run-server"
      ],
      "env": {
        "IMPALA_HOST": "coordinator-default-impala.example.com",
        "IMPALA_PORT": "443",
        "IMPALA_USER": "username",
        "IMPALA_PASSWORD": "password",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

使用例

基本的な使用方法

MCPサーバーの基本的な使用方法を以下に示します：

Claude Desktopでの使用

1MCPサーバーの起動確認

Claude Desktopを開き、設定が正しく読み込まれていることを確認してください。

2基本コマンドの実行


   Available tools from this MCP server:
   - tool1: Description of tool1
   - tool2: Description of tool2

プログラムでの使用

python
Python例
import requests

def call_mcp_tool(tool_name, params):
    response = requests.post(
        'http://localhost:3000/mcp/call',
        json={
            'tool': tool_name,
            'parameters': params
        }
    )
    return response.json()

使用例
result = call_mcp_tool('analyze', {
    'input': 'sample data',
    'options': {'format': 'json'}
})