Iceberg MCP服务器

Iceberg MCP是一个为Apache Iceberg目录提供异步和日志功能的MCP服务器。

  • by morristai
  • Rust
  • 本地部署
  • 36 星标
  • 更新于
在 GitHub 查看 morristai/iceberg-mcp

使用说明

冰山MCP

一 主控程序 服务器 阿帕奇冰山 具有异步和日志功能的目录。

冰山MCP演示

支持的目录

目录类型 支持
休息目录 ✅
AWS胶水 ✅
Hive元存储库 ❌
S3表 ❌

支持的工具

工具 说明
namespaces 获取冰山目录中的所有命名空间
tables 获取给定命名空间的所有表
table_schema 返回给定表的架构
table_properties 返回给定表的表属性

安装

选项1:下载发布二进制文件

从下载最新的预构建二进制文件 发布页面.

选项2:从源代码构建

要手动构建项目,请确保 锈 已安装,然后运行:

cargo build --release

编译后的二进制文件将位于: ./target/release/iceberg-mcp

客户端配置

克劳德桌面

要将Iceberg MCP与Claude Desktop集成,请执行以下操作:

  1. 打开 Settings > Developer > Edit Config.
  2. 更新 claude_desktop_config.json 通过适当的配置:
  • 休息目录
{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "PATH-TO-BINARY/iceberg-mcp",
      "env": {
        "CATALOG_KIND": "rest",
        "REST_URI": "http://localhost:8080",
        "LOG_LEVEL": "info"
      }
    }
  }
}
  • AWS胶水目录
// use PROFILE_NAME
{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "PATH-TO-BINARY/iceberg-mcp",
      "env": {
        "CATALOG_KIND": "glue",
        "AWS_CONFIG_FILE": "/Users/{your_username}/.aws/config",
        "AWS_SHARED_CREDENTIALS_FILE": "/Users/{your_username}/.aws/credentials",
        "PROFILE_NAME": "default",
        "GLUE_WAREHOUSE": "s3://{bucket_name}",
        "GLUE_ENDPOINT": "http://localhost:9000", // Glue service endpoint, optional
        "LOG_LEVEL": "info"
      }
    }
  }
}

// or use ACCESS_KEY and SECRET_KEY
{
  "mcpServers": {
    "iceberg-mcp": {
      "command": "PATH-TO-BINARY/iceberg-mcp",
      "env": {
        "CATALOG_KIND": "glue",
        "GLUE_WAREHOUSE": "s3a://{bucket_name}",
        "GLUE_ENDPOINT": "http://localhost:9000", // Optional
        "AWS_ACCESS_KEY_ID": "my_access_id",
        "AWS_SECRET_ACCESS_KEY": "my_secret_key",
        "AWS_REGION_NAME": "us-east-1",
        "S3_ENDPOINT": "http://localhost:9000",
        "S3_ACCESS_KEY_ID": "admin",
        "S3_SECRET_ACCESS_KEY": "password",
        "S3_REGION": "us-east-1",
        "LOG_LEVEL": "info"
      }
    }
  }
}

调试

克劳德桌面

查看日志以排除以下故障:

tail -n 20 -F ~/Library/Logs/Claude/mcp-server-iceberg-mcp.log