MCP ExplorerExplorer

Codeql Mcp

@JordyZomeron 25 days ago
88 MIT
FreeCommunity
AI Systems
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.

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.

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

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.

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers