Этот проект запускает сервер Model Context Protocol (MCP), который обворачивает сервер запросов CodeQL. Он позволяет таким инструментам, как Cursor или агентам AI, взаимодействовать с CodeQL через структурированные команды и поиск документов.

---

Особенности

• ✅ Базы данных Register CodeQL
• ✅ Выполнять полные запросы или быстро оценивать символ
• ✅ Декодировать файлы .bqrs в JSON
• ✅ Найти позиции символов предиката/класса

---

Структура файла

---

Требования

Установка с помощью uv:

или с pip:

Запуск сервера MCP

• Запускает сервер в http://localhost:8000/sse
• Требуется для использования курсора или агента ИИ

Конфигурация курсора

Убедитесь, что ваш .cusor/config.json содержит:

Примечания

• Инструменты, такие как Cursor, вызывают эти команды напрямую через естественный язык.
• В вашем $PATH должен быть бинарный код codeql или жёстко закодировать его путь в codeqlclient.py.
• Вам, вероятно, стоит указать расположения запросов, записи запросов и пути к базе данных в ваших запросах.

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

---

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.