🚀 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 中硬编码其路径。
• 你可能需要指定查询位置、写入位置和数据库路径。