chakra-mcp 0.1.0

A native MCP server integration for Chakra databases

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
• Chakra Account - sign up here

Finding your DB Session Key

1. Login to the Chakra Console
2. Select Settings
3. Navigate to the releveant database and copy the DB Session Key (not the access key or secret access key)

https://github.com/user-attachments/assets/9f1c1ab8-cb87-42a1-8627-184617bbb7d7

Installation

Automated Using OpenTools (Easier)

TBD

Manual Setup (More Work)

Clone the repository by running:

git clone https://github.com/Chakra-Network/mcp-server.git

Install dependencies using uv:

uv sync

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": "uv",
      "args": [
          "--directory",
          "/path/to/mcp-server",
          "run",
          "src/server.py"
      ],
      "env": {
        "db_session_key": "YOUR_DB_SESSION_KEY"
      }
    }
  }
}

Architecture

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 on Anthropic's part and is not yet configurable.
• Setup is rough around the edges. We have worked closely with the folks at OpenTools to make this as seamless as possible, but there is room for improvement. We are looking forward to an MCP GUI experience in the future, but for now, users must use the command-line.
• Today, the server runs on the user's local machine. Anthropic's roadmap includes a hosted server option, which we will support. This will make authentication, setup, and performance much better.

License

MIT License - see LICENSE file for details.

Support

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