Codeql

🚀 CodeQL MCP サーバー

このプロジェクトは、CodeQL クエリサーバーをラップするモデルコンテキストプロトコル（MCP）サーバーを実行します。これにより、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 の設定

.cursor/config.json が以下の内容を含むことを確認してください。

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

📚 ドキュメント

ファイル構造

注意事項

⚠️ 重要提示

• Cursor などのツールは自然言語でこれらのコマンドを直接呼び出します。
• PATH に codeql 実行ファイルが存在するか、codeqlclient.py でそのパスをハードコードする必要があります。
• クエリの位置、クエリの書き込み先、データベースのパスをプロンプトで指定する必要がある場合があります。