📌Overview

Purpose: To provide a native integration with Anthropic's Model Context Protocol (MCP), enabling users to interact with databases and data shares through natural language.

Overview: Chakra MCP Server allows seamless interaction with databases and subscribed data shares using conversational queries, simplifying data management and retrieval in an intuitive way.

Key Features:

Natural Language Queries: Enables users to formulate database queries in plain language, making data access easier for non-technical users.
Data Share Interactions: Provides functionality to engage with various data shares, allowing users to extract specific information (e.g., stock prices) from subscribed resources.
Database Management: Includes capabilities for creating, updating, and deleting database tables, giving users comprehensive control over their data structures.

Chakra MCP Server

A native integration with Anthropic's Model Context Protocol (MCP). Allows you to interact with your database and subscribed data shares using natural language.

Features

Natural Language Queries: Query your database using natural language.
Data Share Interactions: Interact with subscribed data shares. For example, if you have subscribed to a financial data share, you can ask questions like "What is the stock price of Tesla?"
Database Management: Create, update, and delete tables.

Demo

https://github.com/user-attachments/assets/0d1b3588-4dec-4fae-8396-d1794177a23c

Prerequisites

Python 3.11+
uv. On MacOS, you can install it using Homebrew: brew install uv.
Claude Desktop
Chakra Account - sign up at https://console.chakra.dev/

Finding your DB Session Key

Login to the Chakra Console at https://console.chakra.dev/
Select Settings
Navigate to the relevant database and copy the DB Session Key (not the access key or secret access key)

Installation

Automated Using OpenTools (Easier)

Install OpenTools prerequisites as described on https://opentools.com/docs/registry/quickstart#prerequisites.

Then run:

npx opentools@latest i chakra

Manual Setup (More Work)

Add the following to your claude_desktop_config.json file:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "chakra": {
      "command": "uvx",
      "args": ["chakra-mcp"],
      "env": {
        "db_session_key": "YOUR_DB_SESSION_KEY"
      }
    }
  }
}

Disclaimers

MCP is extremely early. The experience in Claude Desktop is suboptimal — every time you use the server, you have to grant access explicitly. This is a design decision by Anthropic and is not yet configurable.
Setup is rough around the edges. Collaboration with OpenTools aims to improve this, but currently users must use the command-line.
The server currently runs on the user's local machine. Anthropic's roadmap includes a hosted server option, which will improve authentication, setup, and performance.

License

MIT License - see LICENSE file for details.

Support

For support and questions, please open an issue in the GitHub repository or reach out on Discord.

Contributing

Creating a new build:

uv build

Publishing a new version:

uv publish

mcp-server