CodeQL MCP Server

CodeQL MCP 服务

此项目运行一个封装 CodeQL 查询服务的模型上下文协议（MCP）服务。它使 Cursor 等工具或 AI Agent 能够通过结构化命令和文档搜索与 CodeQL 交互。

---

功能

• ✅ 注册 CodeQL 数据库
• ✅ 运行完整查询或快速评估符号
• ✅ 将 .bqrs 文件解码为 JSON
• ✅ 定位谓词/类符号的位置

---

文件结构

文件	用途
server.py	用于公开 CodeQL 工具的 FastMCP 主服务
codeqlclient.py	CodeQLQueryServer 实现（JSON-RPC 处理程序）

---

要求

使用 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 Agent 使用时必需

Cursor 配置

确保你的 .cusor/config.json 包含：

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

注意事项

• Cursor 等工具会通过自然语言直接调用这些命令。
• 你必须在 $PATH 中有一个 codeql 二进制文件，或者在 codeqlclient.py 中硬编码其路径。
• 你最好在提示词中指定查询位置、查询写入位置和数据库路径。