[{"_1":2,"_229":-5,"_230":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_182":183},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","v3B1agAsRP","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":40,"_99":100,"_181":79},"availableLocales",[],"githubUser","locale",{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","An 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.","name","IcebergMCP","readme","

\n\n\n\n $\"Iceberg$ \n\n# IcebergMCP 🚀\nAI-native Lakehouse Integration\n\n[![PyPI - Version](https://img.shields.io/pypi/v/iceberg-mcp.svg)](https://pypi.org/project/iceberg-mcp)\n[![License](https://img.shields.io/github/license/ryft-io/iceberg-mcp)](https://github.com/ryft-io/iceberg-mcp/blob/main/LICENSE)\n\n

\n\nIcebergMCP is a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that lets you interact with your [Apache Iceberg™](https://iceberg.apache.org/) Lakehouse using natural language in Claude, Cursor, or any other MCP client.\n\n

\n\n\n## Table of Contents\n- [Installation](#installation)\n - [Prerequisites](#prerequisites)\n - [Claude](#claude)\n - [Cursor](#cursor)\n- [Configuration](#configuration)\n- [Available Tools](#available-tools)\n- [Examples](#examples)\n- [Limitations & Security Considerations](#limitations--security-considerations)\n- [Contributing](#contributing)\n\n\n\n## Installation\n\n\n### Prerequisites\n\n- Apache Iceberg™ catalog managed in AWS Glue\n- AWS profile configured on the machine, with access to the catalog\n- `uv` package manager - install via `brew install uv` or see [official installation guide](https://docs.astral.sh/uv/getting-started/installation/)\n\n\n### Claude\n1. Inside Claude, go to Settings > Developer > Edit Config > claude_desktop_config.json\n\n2. Add the following:\n```json\n{\n \"mcpServers\": {\n \"iceberg-mcp\": {\n \"command\": \"uv\", // If uv can't be found, replace with full absolute path to uv\n \"args\": [\n \"run\",\n \"--with\",\n \"iceberg-mcp\",\n \"iceberg-mcp\"\n ],\n \"env\": {\n \"ICEBERG_MCP_PROFILE\": \"\"\n }\n }\n }\n}\n```\n\n\n### Cursor\n1. Inside Cursor, go to Settings -> Cursor Settings -> MCP -> Add new global MCP server\n\n\n2. Add the following:\n```json\n{\n \"mcpServers\": {\n \"iceberg-mcp\": {\n \"command\": \"uv\", // If uv can't be found, replace with full absolute path to uv\n \"args\": [\n \"run\",\n \"--with\",\n \"iceberg-mcp\",\n \"iceberg-mcp\"\n ],\n \"env\": {\n \"ICEBERG_MCP_PROFILE\": \"\"\n }\n }\n }\n}\n```\n\n\n## Configuration\n\nEnvironment variables can be used to configure the AWS connection:\n\n- `ICEBERG_MCP_PROFILE` - The AWS profile name to use. This role will be assumed and used to connect to the catalog and the object storage. If not specified, the default role will be used.\n- `ICEBERG_MCP_REGION` - The AWS region to use. This is used to determine the catalog and object storage location. `us-east-1` by default.\n\n\n## Available Tools\n\nThe server provides the following tools for interacting with your Apache Iceberg™ tables:\n\n- `get_namespaces`: Gets all namespaces in the Apache Iceberg™ catalog\n- `get_iceberg_tables`: Gets all tables for a given namespace\n- `get_table_schema`: Returns the schema for a given table\n- `get_table_properties`: Returns table properties for a given table, like total size and record count\n- `get_table_partitions`: Gets all partitions for a given table\n\n\n## Examples\n\nOnce installed and configured, you can start interacting with your Apache Iceberg™ tables through your MCP client. Here are some simple examples of how to interact with your lakehouse:\n\n1. \"List all namespaces in my catalog\"\n2. \"List all tables for the namespace called `bronze`\"\n3. \"What are all the string columns in the table `raw_events`?\n4. \"What is the size of the `raw_events` table?\"\n5. \"Generate an SQL query that calculates the sum and the p95 of all number columns in `raw_metrics` for all VIP users from `users_info`\"\n5. \"Why did the queries on `raw_events` recently become much slower?\"\n\n\n## Limitations & Security Considerations\n\n- All tools are currently read-only and cannot modify or delete data from your lakehouse\n- Currently supported catalogs:\n - AWS Glue\n - Apache Iceberg™ REST Catalog (coming soon!)\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","English","tag","en-US",{"_41":42,"_43":-5,"_13":44,"_46":32,"_47":32,"_48":49,"_52":53,"_75":-5,"_76":77,"_78":79,"_80":81,"_33":34,"_82":66,"_83":-5,"_84":-5,"_85":-5,"_86":-5,"_87":88,"_92":-5,"_93":62,"_94":-5,"_95":-5,"_17":96,"_97":98},"addedAt",["D",1744376561495],"argumentsJsonSchema",[45],"language:python","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":36,"_50":51},"url","https://github.com/ryft-io/iceberg-mcp","githubRepository",{"_54":55,"_56":57,"_58":59,"_60":61,"_33":62,"_63":64,"_68":69,"_70":71,"_73":74},"defaultBranch","main","fullName","ryft-io/iceberg-mcp","githubTreeId",107179,"language","Python","iceberg-mcp","owner",{"_65":66,"_17":67},"login","ryft-io","ZCVUOr0i5m","recentStargazers",0,"spdxLicense",{"_33":72},"Apache 2.0","stargazers",31,"glamaJson","id",5333,"inspectable",false,"integrations",[],"namespace","npmPackage","prompts","redditPostForeignId","resources","scores",{"_89":-5,"_90":-5,"_91":-5},"license","quality","security","simpleIcon","slug","supportedPlatforms","tools","ah3o6yyv20","updatedAt",["D",1745147613118],"meta",[101,104,106,113,116,118,121,124,127,130,133,135,138,141,143,145,147,149,151],{"_102":103},"title","IcebergMCP | Glama",{"_105":32,"_33":31},"content",{"_107":108,"_109":110,"_111":112},"href","https://glama.ai/mcp/servers/@ryft-io/iceberg-mcp","rel","canonical","tagName","link",{"_105":34,"_114":115},"property","og:title",{"_105":32,"_114":117},"og:description",{"_105":119,"_114":120},"https://glama.ai/logo.png","og:logo",{"_105":122,"_114":123},"https://glama.ai/mcp/servers/@ryft-io/iceberg-mcp/og-image","og:image",{"_105":125,"_114":126},"630","og:image:height",{"_105":128,"_114":129},"1200","og:image:width",{"_105":131,"_114":132},"website","og:type",{"_105":108,"_114":134},"og:url",{"_105":136,"_114":137},"ChatGPT alternative for power users","og:site_name",{"_105":139,"_33":140},"summary_large_image","twitter:card",{"_105":136,"_33":142},"twitter:title",{"_105":32,"_33":144},"twitter:description",{"_105":122,"_33":146},"twitter:image",{"_105":125,"_33":148},"twitter:image:height",{"_105":128,"_33":150},"twitter:image:width",{"_152":153},"script:ld+json",{"_154":155,"_156":157},"@context","http://schema.org","@graph",[158],{"_154":159,"_160":161,"_162":163},"https://schema.org","@type","BreadcrumbList","itemListElement",[164,171,175,179],{"_160":165,"_166":167,"_33":168,"_169":170},"ListItem","item","https://glama.ai/","Glama","position",1,{"_160":165,"_166":172,"_33":173,"_169":174},"https://glama.ai/mcp","MCP",2,{"_160":165,"_166":176,"_33":177,"_169":178},"https://glama.ai/mcp/servers","Servers",3,{"_160":165,"_166":108,"_33":34,"_169":180},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_26":-5,"_29":184,"_99":194,"_228":-5},{"_41":185,"_43":-5,"_13":186,"_46":32,"_47":32,"_48":187,"_52":188,"_75":-5,"_76":77,"_78":79,"_80":191,"_33":34,"_82":66,"_83":-5,"_84":-5,"_85":-5,"_86":-5,"_87":192,"_92":-5,"_93":62,"_94":-5,"_95":-5,"_17":96,"_97":193},["D",1744376561495],[45],{"_35":36,"_50":51},{"_54":55,"_56":57,"_58":59,"_60":61,"_33":62,"_63":189,"_68":69,"_70":190,"_73":74},{"_65":66,"_17":67},{"_33":72},[],{"_89":-5,"_90":-5,"_91":-5},["D",1745147613118],[195,197,198,200,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216],{"_102":196},"Reviews | IcebergMCP | Glama",{"_105":32,"_33":31},{"_107":199,"_109":110,"_111":112},"https://glama.ai/mcp/servers/@ryft-io/iceberg-mcp/reviews",{"_105":201,"_114":115},"Reviews | IcebergMCP",{"_105":32,"_114":117},{"_105":119,"_114":120},{"_105":122,"_114":123},{"_105":125,"_114":126},{"_105":128,"_114":129},{"_105":131,"_114":132},{"_105":199,"_114":134},{"_105":136,"_114":137},{"_105":139,"_33":140},{"_105":136,"_33":142},{"_105":32,"_33":144},{"_105":122,"_33":146},{"_105":125,"_33":148},{"_105":128,"_33":150},{"_152":217},{"_154":155,"_156":218},[219],{"_154":159,"_160":161,"_162":220},[221,222,223,224,225],{"_160":165,"_166":167,"_33":168,"_169":170},{"_160":165,"_166":172,"_33":173,"_169":174},{"_160":165,"_166":176,"_33":177,"_169":178},{"_160":165,"_166":108,"_33":34,"_169":180},{"_160":165,"_166":199,"_33":226,"_169":227},"Reviews",5,"review","actionData","errors"]

Rate & Review