Cloudera Iceberg MCP Server (via Impala)

Cloudera Iceberg MCP 服务（通过 Impala）

这是一个通过 Apache Impala 提供 Iceberg 表只读访问的模型上下文协议服务。此服务可让大模型检查数据库架构并执行只读查询。

• execute_query(query: str)：在 Impala 上运行任意 SQL 查询，并以 JSON 格式返回结果。
• get_schema()：列出当前数据库中所有可用的表。

在 Claude Desktop 中使用

若要在 Claude Desktop 桌面应用中使用此服务，请将以下配置添加到 claude_desktop_config.json 的 "mcpServers" 部分：

选项 1：直接从 GitHub 安装（推荐）

{
  "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"
      }
    }
  }
}

选项 2：本地安装（克隆仓库后）

{
  "mcpServers": {
    "iceberg-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/iceberg-mcp-server",
        "run",
        "src/iceberg_mcp_server/server.py"
      ],
      "env": {
        "IMPALA_HOST": "coordinator-default-impala.example.com",
        "IMPALA_PORT": "443",
        "IMPALA_USER": "username",
        "IMPALA_PASSWORD": "password",
        "IMPALA_DATABASE": "default"
      }
    }
  }
}

对于选项 2，请将 /path/to 替换为此仓库的路径。根据 Impala 配置设置环境变量。

与 AI 框架搭配使用

./examples 文件夹中包含多个示例，介绍如何将此 MCP 服务与 LangChain/LangGraph、OpenAI SDK 等常见 AI 框架集成。

传输方式

可通过 MCP_TRANSPORT 环境变量配置 MCP 服务的传输协议。支持的值：

• stdio （默认） — 通过标准输入/输出进行通信。适用于本地工具、命令行脚本，以及与 Claude Desktop 等客户端的集成。
• http - 暴露 HTTP 服务。适用于 Web 部署、微服务，以及通过网络暴露 MCP。
• sse — 使用服务器发送事件（SSE）传输方式。适用于依赖 SSE 的现有 Web 部署。

版权所有 (c) 2025 - Cloudera, Inc. 保留所有权利。