Qmcp MCP Server

A Model Context Protocol (MCP) server for q/kdb+ integration.

Local serverstdioPython

What is the Qmcp MCP server?

Qmcp MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. A Model Context Protocol (MCP) server for q/kdb+ integration.

What you get

  • Connect to q/kdb+ servers
  • Execute q queries and commands
  • Persistent connection management
  • Intelligent async query handling with configurable timeouts
  • Programmatic query cancellation (Ctrl+C equivalent)
  • Graceful handling of long-running queries

Setting it up

The server ships on PyPI as qmcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Configuration and credentials

You will need one environment variable: Q_DEFAULT_HOST. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Python 3.8+ - Access to a q/kdb+ server - uv (for lightweight installation) or pip (for full installation)

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the qmcp mcp server does with a few real requests.

Choosing this one

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. It is maintained by gabiteodoru; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

How to install the Qmcp MCP server

For uv-based installation:
```json
{
  "mcpServers": {
    "qmcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/qmcp",
        "run",
        "qmcp"
      ]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.8+ - Access to a q/kdb+ server - uv (for lightweight installation) or pip (for full installation)
VariableDescriptionRequired
Q_DEFAULT_HOSTEndpoint or connection string the server talks to.Optional

Frequently asked questions

It connects Qmcp to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Qmcp directly.