- Explore MCP Servers
- codeql-mcp
Codeql Mcp
What is Codeql Mcp
codeql-mcp is a Model Context Protocol (MCP) server that integrates with the CodeQL query server, allowing tools like Cursor or AI agents to interact with CodeQL through structured commands and document searches.
Use cases
Use cases for codeql-mcp include integrating CodeQL queries into development tools, enabling AI agents to perform code analysis, and facilitating document searches related to code queries.
How to use
To use codeql-mcp, install the required packages using ‘uv’ or ‘pip’, then run the MCP server with ‘uv run mcp run server.py -t sse’. Ensure your Cursor configuration points to the MCP server URL.
Key features
Key features of codeql-mcp include the ability to register CodeQL databases, run full queries or quickly evaluate symbols, decode .bqrs files into JSON, and locate predicate/class symbol positions.
Where to use
codeql-mcp can be used in software development, security analysis, and any domain requiring code analysis and querying using CodeQL.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Codeql Mcp
codeql-mcp is a Model Context Protocol (MCP) server that integrates with the CodeQL query server, allowing tools like Cursor or AI agents to interact with CodeQL through structured commands and document searches.
Use cases
Use cases for codeql-mcp include integrating CodeQL queries into development tools, enabling AI agents to perform code analysis, and facilitating document searches related to code queries.
How to use
To use codeql-mcp, install the required packages using ‘uv’ or ‘pip’, then run the MCP server with ‘uv run mcp run server.py -t sse’. Ensure your Cursor configuration points to the MCP server URL.
Key features
Key features of codeql-mcp include the ability to register CodeQL databases, run full queries or quickly evaluate symbols, decode .bqrs files into JSON, and locate predicate/class symbol positions.
Where to use
codeql-mcp can be used in software development, security analysis, and any domain requiring code analysis and querying using CodeQL.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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 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
:
uv pip install -r requirements.txt
or with pip
:
pip install fastmcp httpx
Running the MCP Server
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.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.