{"id":26937399,"url":"https://github.com/ognis1205/mcp-server-unitycatalog","last_synced_at":"2025-04-02T13:15:17.382Z","repository":{"id":275991205,"uuid":"926414362","full_name":"ognis1205/mcp-server-unitycatalog","owner":"ognis1205","description":"Unity Catalog AI Model Context Protocol Server","archived":false,"fork":false,"pushed_at":"2025-02-24T00:56:44.000Z","size":12184,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-24T01:39:59.329Z","etag":null,"topics":["llm","mcp","modelcontextprotocol","unitycatalog"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ognis1205.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-03T07:59:19.000Z","updated_at":"2025-02-24T00:56:47.000Z","dependencies_parsed_at":"2025-02-05T17:44:46.616Z","dependency_job_id":"5c4eebdc-86f2-4782-9d00-58559af4e173","html_url":"https://github.com/ognis1205/mcp-server-unitycatalog","commit_stats":null,"previous_names":["ognis1205/mcp-server-unitycatalog"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ognis1205%2Fmcp-server-unitycatalog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ognis1205%2Fmcp-server-unitycatalog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ognis1205%2Fmcp-server-unitycatalog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ognis1205%2Fmcp-server-unitycatalog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ognis1205","download_url":"https://codeload.github.com/ognis1205/mcp-server-unitycatalog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246819773,"owners_count":20839095,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["llm","mcp","modelcontextprotocol","unitycatalog"],"created_at":"2025-04-02T13:15:11.596Z","updated_at":"2025-04-02T13:15:17.369Z","avatar_url":"https://github.com/ognis1205.png","language":"Python","funding_links":[],"categories":["Data Access \u0026 Integration Mcp Servers","Community Servers","🤖 AI/ML","Data \u0026 Analytics","Cloud Services","Data Platforms","🗂️ Extensions by Category","Table of Contents"],"sub_categories":["Data Platforms","How to Submit","⚙️ Development Tools","AI Services"],"readme":"# mcp-server-unitycatalog: An Unity Catalog MCP server\n\n\u003cp align=\"center\" float=\"left\"\u003e\n  \u003cimg width=\"256\" src=\"https://raw.githubusercontent.com/ognis1205/mcp-server-unitycatalog/main/docs/vscode1.webp\" /\u003e\n  \u003cimg width=\"256\" src=\"https://raw.githubusercontent.com/ognis1205/mcp-server-unitycatalog/main/docs/vscode2.webp\" /\u003e\n  \u003cimg width=\"256\" src=\"https://raw.githubusercontent.com/ognis1205/mcp-server-unitycatalog/main/docs/vscode3.webp\" /\u003e\n\u003c/p\u003e\n\n## Overview\n\nA Model Context Protocol server for [Unity Catalog](https://www.unitycatalog.io/). This server provides [Unity Catalog Functions](https://docs.unitycatalog.io/usage/functions/) as MCP tools.\n\n### Tools\n\nYou can use **all Unity Catalog Functions registered in Unity Catalog** alongside the following predefined Unity Catalog AI tools:\n\n1. `uc_list_functions`\n   - Lists functions within the specified parent catalog and schema.\n   - Returns: A list of functions retrieved from Unity Catalog.\n\n2. `uc_get_function`\n   - Gets a function within a parent catalog and schema.\n   - Input:\n     - `name` (string): The name of the function (not fully-qualified).\n   - Returns: A function details retrieved from Unity Catalog.\n\n3. `uc_create_function`\n   - Creates a function within a parent catalog and schema. **WARNING: This API is experimental and will change in future versions**.\n   - Input:\n     - `name` (string): The name of the function (not fully-qualified).\n     - `script` (string): The Python script including the function to be registered.\n   - Returns: A function details created within Unity Catalog.\n\n4. `uc_delete_function`\n   - Deletes a function within a parent catalog and schema.\n   - Input:\n     - `name` (string): The name of the function (not fully-qualified).\n   - Returns: None.\n\n## Installation\n\n### Using uv\n\nWhen using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will use\n[`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-git*.\n\n## Configuration\n\nThese values can also be set via CLI options or `.env` environment variables. Required arguments are the Unity Catalog server, catalog, and schema, while the access token and verbosity level are optional. Run `uv run mcp-server-unitycatalog --help` for more detailed configuration options.\n\n| Argument                   | Environment Variable | Description                                                                        | Required/Optional |\n|----------------------------|----------------------|------------------------------------------------------------------------------------|-------------------|\n| `-u`, `--uc_server`        | `UC_SERVER`          | The base URL of the Unity Catalog server.                                          | Required          |\n| `-c`, `--uc_catalog`       | `UC_CATALOG`         | The name of the Unity Catalog catalog.                                             | Required          |\n| `-s`, `--uc_schema`        | `UC_SCHEMA`          | The name of the schema within a Unity Catalog catalog.                             | Required          |\n| `-t`, `--uc_token`         | `UC_TOKEN`           | The access token used to authorize API requests to the Unity Catalog server.       | Optional          |\n| `-v`, `--uc_verbosity`     | `UC_VERBOSITY`       | The verbosity level for logging. Default: `warn`.                                  | Optional          |\n| `-l`, `--uc_log_directory` | `UC_LOG_DIRECTORY`   | The directory where log files will be stored. Default: `.mcp_server_unitycatalog`. | Optional          |\n\n### Usage with Claude Desktop or VSCode Cline\n\nAdd this to your `claude_desktop_config.json` (or `cline_mcp_settings.json`):\n\n\u003cdetails\u003e\n\u003csummary\u003eUsing uv\u003c/summary\u003e\n\n```json\n{\n  \"mcpServers\": {\n    \"unitycatalog\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/\u003cpath to your local git repository\u003e/mcp-server-unitycatalog\",\n        \"run\",\n        \"mcp-server-unitycatalog\",\n        \"--uc_server\",\n        \"\u003cyour unity catalog url\u003e\",\n        \"--uc_catalog\",\n        \"\u003cyour catalog name\u003e\",\n        \"--uc_schema\",\n        \"\u003cyour schema name\u003e\"\n      ]\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eUsing docker\u003c/summary\u003e\n\n* Note: replace '/Users/username' with the a path that you want to be accessible by this tool\n\n```json\n{\n  \"mcpServers\": {\n    \"unitycatalog\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"--rm\",\n        \"-i\",\n        \"mcp/unitycatalog\",\n        \"--uc_server\",\n        \"\u003cyour unity catalog url\u003e\",\n        \"--uc_catalog\",\n        \"\u003cyour catalog name\u003e\",\n        \"--uc_schema\",\n        \"\u003cyour schema name\u003e\"\n      ]\n    }\n  }\n}\n```\n\u003c/details\u003e\n\n## Building\n\nDocker:\n\n```bash\ndocker build -t mcp/unitycatalog .   \n```\n\n## Future Plans\n\n- [x] Implement support for `list_functions`.\n- [x] Implement support for `get_function`.\n- [x] Implement support for `create_python_function`.\n- [x] Implement support for `execute_function`.\n- [x] Implement support for `delete_function`.\n- [ ] Implement semantic catalog explorer tools.\n- [x] Add Docker image.\n- [ ] Implement `use_xxx` methods. In the current implementation, `catalog` and `schema` need to be defined when starting the server. However, they will be implemented as `use_catalog` and `use_schema` functions, dynamically updating the list of available functions when the `use_xxx` is executed.\n\n## License\n\nThis MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fognis1205%2Fmcp-server-unitycatalog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fognis1205%2Fmcp-server-unitycatalog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fognis1205%2Fmcp-server-unitycatalog/lists"}