How do I start the CodeQL MCP Server?

Run `uv run mcp run server.py -t sse` from the project directory. The server will listen on `http://localhost:8000/sse` by default.

How do I configure Cursor to use the CodeQL MCP Server?

Add a `"CodeQL"` entry under `"mcpServers"` in your `.cursor/config.json`, pointing the `"url"` to `"http://localhost:8000/sse"`.

SSyncDev

Start a project

CodeQL MCP Server

This project runs a Model Context Protocol (MCP) server that wraps the CodeQL query server. It enables tools like [Cursor](https://cursor.sh/) or AI

Local serverstdio

What is the CodeQL MCP Server?

This project runs a Model Context Protocol (MCP) server that wraps the CodeQL query server. It enables tools like Cursor or AI agents to

The short version

✅ Register CodeQL databases
✅ Run full queries or quick-evaluate a symbol
✅ Decode .bqrs files into JSON
✅ Locate predicate/class symbol positions

What it needs from you

Install with uv: or with pip:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
server.py	Main FastMCP server exposing CodeQL tools
codeqlclient.py	CodeQLQueryServer implementation (JSON-RPC handler)

Configuration

Install with uv: or with pip:

Example prompts to try

“Use CodeQL to File.”
“Use CodeQL to server.py.”
“Use CodeQL to codeqlclient.py.”

Frequently asked questions

Python packages `fastmcp` and `httpx` are required, and a `codeql` binary must be available in your `$PATH` (or its path can be hardcoded in `codeqlclient.py`).