mirror of https://github.com/googleapis/genai-toolbox.git synced 2026-02-04 12:15:09 -05:00

Files

Twisha Bansal e0245946ea docs: standardize installation note for antigravity plugins (#2373 )

## Description

> Should include a concise description of the changes (bug or feature),
it's
> impact, along with a summary of the solution

## PR Checklist

> Thank you for opening a Pull Request! Before submitting your PR, there
are a
> few things you can do to make sure it goes smoothly:

- [x] Make sure you reviewed

[CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md)
- [ ] Make sure to open an issue as a

[bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose)
  before writing your code! That way we can discuss the change, evaluate
  designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)
- [ ] Make sure to add `!` if this involve a breaking change

🛠️ Fixes #<issue_number_goes_here>

2026-01-30 10:25:29 +05:30

3.2 KiB

Raw Blame History

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.

Install & Configuration

In the Antigravity MCP Store, click the "Install" button.

Note

On first use, the installation process automatically downloads and uses MCP Toolbox >=0.26.0. To update MCP Toolbox, use: npm i -g @toolbox-sdk/server@latest To always run the latest version, update the MCP server configuration to use: npx -y @toolbox-sdk/server@latest --prebuilt dataplex.
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.

3.2 KiB Raw Blame History