Codeql

🚀 CodeQL MCP 服務器

本項目運行一個模型上下文協議（MCP）服務器，該服務器對 CodeQL 查詢服務器進行了封裝。藉助此服務器，工具（例如 Cursor 或 AI 代理）能夠通過結構化命令和文檔搜索與 CodeQL 開展交互。

🚀 快速開始

先決條件

使用 uv 安裝：

uv pip install -r requirements.txt

或使用 pip：

pip install fastmcp httpx

運行 MCP 服務器

uv run mcp run server.py -t sse

• 服務器將在 http://localhost:8000/sse 啟動。
• 此配置適用於 Cursor 或 AI 代理使用。

Cursor 配置

確保你的 .cursor/config.json 包含以下內容：

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

✨ 主要特性

• ✅ 註冊 CodeQL 數據庫
• ✅ 運行完整查詢或快速評估一個符號
• ✅ 解碼 .bqrs 文件為 JSON
• ✅ 定位謂詞/類符號位置

📚 詳細文檔

文件結構

注意事項

⚠️ 重要提示

• 工具如 Cursor 會通過自然語言直接調用這些命令。
• 你必須在 PATH 中有一個 codeql 可執行文件，或在 codeqlclient.py 中硬編碼其路徑。
• 你可能需要在提示中指定查詢位置、查詢寫入位置和數據庫路徑。