Codeql MCP

🚀 CodeQL MCP 服務器

本項目運行一個模型上下文協議（MCP）服務器，該服務器對 CodeQL 查詢服務器進行了封裝。它能讓工具（例如 Cursor 或者 AI 代理）通過結構化命令以及文檔搜索與 CodeQL 展開交互，為代碼分析和查詢提供了更便捷的途徑。

✨ 主要特性

• ✅ 可註冊 CodeQL 數據庫。
• ✅ 支持運行完整查詢或快速評估符號。
• ✅ 能將 .bqrs 文件解碼為 JSON 格式。
• ✅ 可定位謂詞/類符號的位置。

📦 安裝指南

先決條件

• 使用 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 配置

確保你的 .cusor/config.json 文件包含以下內容：

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

📚 詳細文檔

文件結構

備註

⚠️ 重要提示

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