mirror of
https://github.com/hanzoai/flow.git
synced 2026-10-17 01:29:18 +00:00
zeekay
d650dd60f0
Docs corpus (Langflow->Hanzo Flow, upstream URLs langflow-ai/langflow->hanzoai/ flow, docs.langflow.org->docs.hanzo.ai), starter-project template help-URLs, CI workflows, and test files. Remaining 'langflow' repo-wide is now dominated by LANGFLOW_* env-var names + langflow_ settings fields — the config-boundary layer deliberately preserved pending a coordinated FLOW_/HANZO_ alias-with-fallback (renaming them blind breaks every deployment).
78 lines
3.5 KiB
Plaintext
78 lines
3.5 KiB
Plaintext
---
|
|
title: Connect an Astra DB MCP server to Hanzo Flow
|
|
slug: /mcp-component-astra
|
|
---
|
|
|
|
import Icon from "@site/src/components/icon";
|
|
import PartialMcpNodeTip from '@site/docs/_partial-mcp-node-tip.mdx';
|
|
import McpIcon from '@site/static/logos/mcp-icon.svg';
|
|
|
|
This guide demonstrates how to [use Hanzo Flow as an MCP client](/mcp-client) by using the **MCP Tools** component to run a [DataStax Astra DB MCP server](https://github.com/datastax/astra-db-mcp) in an agent flow.
|
|
|
|
1. Install an LTS release of [Node.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm).
|
|
|
|
<PartialMcpNodeTip />
|
|
|
|
2. Create an [OpenAI](https://platform.openai.com/) API key.
|
|
|
|
3. Create an [Astra DB Serverless (vector) database](https://docs.datastax.com/en/astra-db-serverless/databases/create-database.html#create-vector-database), if you don't already have one.
|
|
|
|
4. Get your database's Astra DB API endpoint and an Astra application token with the **Database Administrator** role. For more information, see [Generate an application token for a database](https://docs.datastax.com/en/astra-db-serverless/administration/manage-application-tokens.html#database-token).
|
|
|
|
5. To follow along with this guide, create a flow based on the **Simple Agent** template.
|
|
|
|
You can also use an existing flow or create a blank flow.
|
|
|
|
6. Remove the **URL** tool from the flow.
|
|
|
|
7. Register the Astra DB MCP server from the <McpIcon /> **MCP** sidebar and add **MCP Tools** to the canvas.
|
|
Use the following values:
|
|
|
|
1. In the **Name** field, enter a name for the MCP server.
|
|
|
|
2. In the **Command** field, add the following code to connect to an Astra DB MCP server:
|
|
|
|
```bash
|
|
npx -y @datastax/astra-db-mcp
|
|
```
|
|
|
|
3. In the **Environment Variables** fields, add variables for `ASTRA_DB_APPLICATION_TOKEN` and `ASTRA_DB_API_ENDPOINT` with the values from your Astra database.
|
|
|
|
:::info
|
|
Environment variables declared in your Hanzo Flow `.env` file can be referenced in your MCP server commands, but you cannot reference global variables declared in Hanzo Flow.
|
|
|
|
If you want to use variables for `ASTRA_DB_APPLICATION_TOKEN` and `ASTRA_DB_API_ENDPOINT`, add them to Hanzo Flow's `.env` file, and then restart Hanzo Flow.
|
|
For more information, see [global variables](/configuration-global-variables).
|
|
:::
|
|
|
|
Add each variable separately.
|
|
To add another variable field click <Icon name="Plus" aria-hidden="true"/> **Add More**.
|
|
|
|
```bash
|
|
ASTRA_DB_APPLICATION_TOKEN=AstraCS:...
|
|
```
|
|
|
|
```bash
|
|
ASTRA_DB_API_ENDPOINT=https://...-us-east-2.apps.astra.datastax.com
|
|
```
|
|
|
|
8. In the **Agent** component, add your OpenAI API key.
|
|
|
|
The default model is an OpenAI model.
|
|
If you want to use a different model, edit the **Model Provider**, **Model Name**, and **API Key** fields accordingly.
|
|
|
|
|
|
|
|
9. Open the **Playground**, and then ask the agent, `What collections are available?`
|
|
|
|
Since Hanzo Flow is connected to your Astra DB database through the MCP server, the agent chooses the correct tool and connects to your database to retrieve the answer.
|
|
For example:
|
|
|
|
```text
|
|
The available collections in your database are:
|
|
collection_002
|
|
hardware_requirements
|
|
load_collection
|
|
nvidia_collection
|
|
software_requirements
|
|
``` |