Codeql MCP

🚀 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の設定

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

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

📚 ドキュメント

注意事項

⚠️ 重要提示

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