Codeql MCP

🚀 CodeQL MCP Server

This project runs a Model Context Protocol (MCP) server that encapsulates the CodeQL query server. It enables tools (such as Cursor or AI agents) to interact with CodeQL through structured commands and document search.

🚀 Quick Start

This project provides a CodeQL MCP server, allowing tools to interact with CodeQL. Below are the steps to get started:

✨ Features

• ✅ Register CodeQL databases.
• ✅ Run full queries or quickly evaluate symbols.
• ✅ Decode .bqrs files to JSON.
• ✅ Locate the positions of predicate/class symbols.

📦 Installation

Prerequisites

You can use uv to install the required dependencies:

uv pip install -r requirements.txt

Or use pip:

pip install fastmcp httpx

💻 Usage Examples

Running the MCP Server

uv run mcp run server.py -t sse

• This will start the server at http://localhost:8000/sse.
• It is suitable for use with Cursor or AI agents.

Cursor Configuration

Make sure your .cusor/config.json contains the following:

{
  "mcpServers": {
    "CodeQL": {
      "url": "http://localhost:8000/sse"
    }
  }
}

📚 Documentation

File Structure

Notes

⚠️ Important Note

• Tools like Cursor will directly invoke these commands through natural language.
• You must have a codeql executable in your $PATH, or hard - code its path in codeqlclient.py.
• You may need to specify the query location, write location, and database path.