Skip to main content

A native MCP server integration for Chakra databases

Project description

Chakra MCP Server

License: MIT

mcp

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+
  • pip
  • 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:

pip install chakra-mcp

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": "python",
      "args": [
        "-m",
        "chakra_mcp"
      ],
      "env": {
        "db_session_key": "YOUR_DB_SESSION_KEY"
      }
    }
  }
}

Architecture

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chakra_mcp-0.1.8.tar.gz (24.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chakra_mcp-0.1.8-py3-none-any.whl (23.2 kB view details)

Uploaded Python 3

File details

Details for the file chakra_mcp-0.1.8.tar.gz.

File metadata

  • Download URL: chakra_mcp-0.1.8.tar.gz
  • Upload date:
  • Size: 24.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.2

File hashes

Hashes for chakra_mcp-0.1.8.tar.gz
Algorithm Hash digest
SHA256 0ddcc7e34418d4f356826ff45c8473ecd513c3489c139e20534657665ceb3659
MD5 fddea1b2f7525ec5c6af25383a4fcce0
BLAKE2b-256 639ea4fc2f3c15e2984df47e6a2ad13f2c851e52691e4f70547b77d7711e7e86

See more details on using hashes here.

File details

Details for the file chakra_mcp-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: chakra_mcp-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 23.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.2

File hashes

Hashes for chakra_mcp-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 fc827e9dbed7e87eed2d56c61190a5d1e77baba360573ab5445e7800263b48fa
MD5 108b27685f4fff44e5d6dc78ac2c64f3
BLAKE2b-256 a77f4e71560b6080a71baed921fa1c01a12fdf6bc2542f8dc5c046fb9b63b931

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page