Cnosdb MCP Server

🚀 CnosDB MCP Server

CnosDB's MCP server provides efficient data query and management capabilities.

🚀 Quick Start

This is CnosDB's MCP server, which offers a range of useful features for database management.

✨ Features

• Query: Execute queries (automatically recognize SQL).
• List Databases: List all databases.
• List Tables: List tables in a database.
• Describe Table: Display the table schema of [table_name].

📦 Installation

Development Setup

# Clone the repository
git clone https://github.com/cnosdb/cnosdb-mcp-server.git
cd cnosdb-mcp-server

# Create a virtual environment
uv .venv
source .venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install development dependencies
pip install -r requirements.txt

Configuration

For other MCP clients, see: https://github.com/punkpeye/awesome-mcp-clients

1. Open the configuration file of Claude Desktop, located at:

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

2. Add the following content:

{
  "name": "CnosDB",
  "key": "CnosDBMCPServer",
  "command": "uv",
  "args": [
    "--directory",
    "REPO_PATH/cnosdb-mcp-server",
    "run",
    "server.py"
  ],
  "env": {
    "CNOSDB_HOST": "127.0.0.1",
    "CNOSDB_PORT": "8902",
    "CNOSDB_USERNAME": "root",
    "CNOSDB_PASSWORD": "CnosDB#!"
  }
}

Update the environment variables to point to your own CnosDB service.

📄 License

This project is licensed under the MIT License.