使用说明
CodeQL MCP服务器
此项目运行一个封装CodeQL查询服务器的模型上下文协议（MCP）服务器。它支持以下工具 光标 或AI代理通过结构化命令和文档搜索与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
- 使用游标或AI代理时需要
游标配置
确保你的 .cusor/config.json 包含：
{
"mcpServers": {
"CodeQL": {
"url": "http://localhost:8000/sse"
}
}
}
备注
- 像Cursor这样的工具将通过自然语言直接调用这些命令。
- 您必须在$PATH中有一个codeql二进制文件，或者在codeqlclient.py中硬编码其路径。
- 您可能应该在提示中指定查询位置、查询写入位置和数据库路径。