CodeQL MCP Server

CodeQL MCP サーバー

このプロジェクトは、CodeQL クエリサーバーをラップする Model Context Protocol（MCP）サーバーを実行します。これにより、Cursor などのツールや 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 で起動します
• Cursor または AI エージェントで使用するには必須です

Cursor の設定

.cusor/config.json に次の内容が含まれていることを確認してください。

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

注意事項

• Cursor などのツールは、自然言語を介してこれらのコマンドを直接呼び出します。
• codeql バイナリを $PATH に配置するか、codeqlclient.py にパスを直接指定する必要があります。
• プロンプトには、クエリの場所、クエリの書き込み先、データベースのパスを指定することをおすすめします。