CodeQL MCP Server

该项目运行一个模型上下文协议（MCP）服务器，该服务器封装了CodeQL查询服务器。它使工具如Cursor或AI代理能够通过结构化命令和文档搜索与CodeQL进行交互。

---

功能

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

---

文件结构

文件	目的
server.py	主FastMCP服务器，公开CodeQL工具
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代理时需要此步骤

Cursor配置

确保你的.cusor/config.json包含以下内容：

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

注意事项

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