이 프로젝트는 CodeQL 쿼리 서버를 감싸는 모델 컨텍스트 프로토콜(MCP) 서버를 운영합니다. 이 서버는 커서나 AI 에이전트와 같은 도구가 구조화된 명령어와 문서 검색을 통해 CodeQL과 상호작용할 수 있도록 합니다.

---

특징

• ✅ Register CodeQL 데이터베이스
• ✅ 전체 쿼리 실행 또는 심볼을 빠르게 평가하기
• ✅ .bqrs 파일을 JSON으로 디코딩
• ✅ 술어/클래스 심볼 위치 위치 위치

---

파일 구조

---

요구 사항

uv로 설치:

또는 pip와 함께:

MCP 서버 실행 중

• 서버를 [[T5]에서 시작합니다.
• 커서 또는 AI 에이전트 사용에 필수

커서 설정

.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.