Back to search
codeql-mcp
MCP serverGitHub
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 agents to interact with CodeQL through structured commands.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/jordyzomer--codeql-mcp)HTML
<a href="/listings/jordyzomer--codeql-mcp"><img src="/api/listings/jordyzomer--codeql-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 61 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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 agents to interact with CodeQL through structured commands and doc search.
- ---
- ## Features
- - ✅ Register CodeQL databases
- - ✅ Run full queries or quick-evaluate a symbol
- - ✅ Decode `.bqrs` files into JSON
- - ✅ Locate predicate/class symbol positions
- ---
- ## File Structure
- | File | Purpose |
- |-------------------|-----------------------------------------------------|
- | `server.py` | Main FastMCP server exposing CodeQL tools |
- | `codeqlclient.py` | CodeQLQueryServer implementation (JSON-RPC handler) |
- ---
- ## Requirements
- Install with [`uv`](https://github.com/astral-sh/uv):
- ```bash
- uv pip install -r requirements.txt
- ```
- or with `pip`:
- ```bash
- pip install fastmcp httpx
- ```
- ## Running the MCP Server
- ```bash
- uv run mcp run server.py -t sse
- ```
- - Starts the server at http://localhost:8000/sse
- - Required for Cursor or AI agent use
- ## Cursor Config
- Make sure your `.cusor/config.json` contains:
- ```
- {
- "mcpServers": {
- "CodeQL": {
- "url": "http://localhost:8000/sse"
- }
- }
- }
- ```
- ## Notes
- - Tools like Cursor will invoke these commands directly via natural language.
- - You must have a codeql binary in your $PATH, or hardcode its path in codeqlclient.py.
- - You should probably specify query locations, query write locations and database paths in your prompts.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.