How to build a LlamaIndex AI agent using ClickHouse MCP Server
In this guide, you'll learn how to build a LlamaIndex AI agent that can interact with ClickHouse's SQL playground using ClickHouse's MCP Server.
This example can be found as a notebook in the examples repository.
Prerequisites
- You'll need to have Python installed on your system.
- You'll need to have
pip
installed on your system. - You'll need an Anthropic API key, or API key from another LLM provider
You can run the following steps either from your Python REPL or via script.
Setup credentials
Next, you'll need to provide your Anthropic API key:
If you don't have an Anthropic API key, and want to use another LLM provider, you can find the instructions for setting up your credentials in the LlamaIndex "LLMs" docs
Initialize MCP Server
Now configure the ClickHouse MCP Server to point at the ClickHouse SQL playground. You'll need to convert those from Python functions into Llama Index tools:
Create an agent
You're now ready to create an agent that has access to those tools. Set the maximum number of tool calls in one run to 10. You can modify this parameter if you want:
Run the agent
Finally, you can ask the agent a question:
The response back is long, so it has been truncated in the example response below: