05799475b4
This PR updates the documentation across the repository to reflect the new installation workflow using `npx` and Node.js, replacing the previous binary download instructions. It also standardizes the prerequisites and adds helpful configuration notes for Windows users. These changes simplify the setup process for users by leveraging `npx` for executing the tools, ensuring they always use the latest version without manual binary management. It also addresses feedback from PR #2079 regarding installation clarity and Windows support. --------- Co-authored-by: Twisha Bansal <twishabansal07@gmail.com>
2.8 KiB
Dataplex MCP Server
The Dataplex Model Context Protocol (MCP) Server gives AI-powered development tools the ability to work with your Google Cloud Dataplex Catalog. It supports searching and looking up entries and aspect types.
Features
An editor configured to use the Dataplex MCP server can use its AI capabilities to help you:
- Search Catalog - Search for entries in Dataplex Catalog
- Explore Metadata - Lookup specific entries and search aspect types
Prerequisites
- Node.js installed.
- A Google Cloud project with the Dataplex API enabled.
- Ensure Application Default Credentials are available in your environment.
- IAM Permissions:
- Dataplex Viewer (
roles/dataplex.viewer) or equivalent permissions to read catalog entries.
- Dataplex Viewer (
Install & Configuration
-
In the Antigravity MCP Store, click the "Install" button.
-
Add the required inputs in the configuration pop-up, then click "Save". You can update this configuration at any time in the "Configure" tab.
You'll now be able to see all enabled tools in the "Tools" tab.
Note
If you encounter issues with Windows Defender blocking the execution, you may need to configure an allowlist. See Configure exclusions for Microsoft Defender Antivirus for more details.
Usage
Once configured, the MCP server will automatically provide Dataplex capabilities to your AI assistant. You can:
- "Search for entries related to 'sales' in Dataplex."
- "Look up details for the entry 'projects/my-project/locations/us-central1/entryGroups/my-group/entries/my-entry'."
Server Capabilities
The Dataplex MCP server provides the following tools:
| Tool Name | Description |
|---|---|
search_entries |
Search for entries in Dataplex Catalog. |
lookup_entry |
Retrieve a specific entry from Dataplex Catalog. |
search_aspect_types |
Find aspect types relevant to the query. |
Custom MCP Server Configuration
The MCP server is configured using environment variables.
export DATAPLEX_PROJECT="<your-gcp-project-id>"
Add the following configuration to your MCP client (e.g., settings.json for Gemini CLI, mcp_config.json for Antigravity):
{
"mcpServers": {
"dataplex": {
"command": "npx",
"args": ["-y", "@toolbox-sdk/server", "--prebuilt", "dataplex", "--stdio"],
"env": {
"DATAPLEX_PROJECT": "your-project-id"
}
}
}
}
Documentation
For more information, visit the Dataplex documentation.