Asterisk MCP Server

Asterisk MCP サーバー

コードスニペットやコードベースのセキュリティスキャン、およびコード変更の検証機能を提供する、Model Context Protocol（MCP）サーバーです。

概要

Asterisk MCP サーバーは、Asterisk セキュリティ API に接続して、コードのリアルタイムセキュリティ分析を提供するミドルウェアコンポーネントです。Model Context Protocol（MCP）を実装し、Claude、Cursor、Cline、Windsurf などの AI アシスタントにセキュリティスキャンツールを提供して、コードのセキュリティ脆弱性を分析できるようにします。

アーキテクチャ

flowchart LR
    IDE["IDE / Code Editor"] <--> |MCP Protocol| MCP["Asterisk MCP Server"]
    MCP <--> |HTTP/HTTPS| API["Asterisk Vulnerability Scanner API"]
    
    classDef primary fill:#6696FF,stroke:#333,stroke-width:1px,color:white;
    classDef secondary fill:#45556B,stroke:#333,stroke-width:1px,color:white;
    classDef tertiary fill:#FFCC00,stroke:#333,stroke-width:1px,color:black;
    
    class IDE primary;
    class MCP secondary;
    class API tertiary;

機能

• コードスニペットのスキャン：個々のコードスニペットを分析して、セキュリティ脆弱性を検出します
• コードベースのスキャン：正確なコンテキストを網羅して複数のファイルをスキャンし、セキュリティ上の問題を検出します
• 変更の検証：チャット履歴内のコード変更によってセキュリティ脆弱性が生じるかどうかを検証します
• 見やすい設定 UI：グラフィカルインターフェースからサーバーを設定できます
• 柔軟なトランスポート：stdio と SSE のトランスポートプロトコルに対応しています
• 包括的なログ機能：詳細なログを記録し、ログの詳細度を設定できます

要件

• Python 3.10+
• pipx / uvx
• httpx
• mcp[cli]
• dearpygui（設定 UI 用）

使用方法

{
  "mcpServers": {
    "asterisk-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "asterisk-mcp-server",
        "--api-url",
        "https://api.mcp.asterisk.so",
        "--transport",
        "stdio",
        "--key",
        "YOUR_API_KEY"
      ],
      "timeout": 3600
    }
  }
}

設定

設定はコマンドライン引数または設定 UI から指定できます。

API サーバーの設定

• --api-url：Asterisk API サーバーのベース URL
• --key：認証用の API キー（API アクセスに必須）
• --timeout：API リクエストのタイムアウト時間（秒単位。0 の場合はタイムアウトしません）

MCP サーバーの設定

• --server-name：MCP サーバーの名前
• --transport：MCP サーバーのトランスポートプロトコル（stdio または sse）
• --port：SSE サーバーのポート（--transport sse と併用）

ログの設定

• --log-level：ログレベル（DEBUG、INFO、WARNING、ERROR、CRITICAL）
• --no-console：コンソールへの出力を無効にします（ファイルへのログ記録のみ）

利用可能なツール

scan_snippet

個々のコードスニペットをスキャンして、セキュリティ脆弱性を検出します。

scan_codebase

複数のファイルをスキャンして、セキュリティ上の問題を検出します。

verify

コード変更によってセキュリティ脆弱性が生じるかどうかを検証します。

settings

ユーザーが「/asterisk」と入力すると、設定 UI を開きます。

データフロー

1. IDE またはコードエディターが、MCP プロトコルを使用して Asterisk MCP サーバーにリクエストを送信します
2. MCP サーバーがリクエストを処理し、Asterisk Vulnerability Scanner API に転送します
3. API がコードを分析し、セキュリティに関する検出結果を返します
4. MCP サーバーが結果を整形し、IDE／エディターに返します
5. IDE／エディターがセキュリティ分析の結果をユーザーに表示します

トラブルシューティング

接続の問題

• API URL が正しく、アクセス可能であることを確認してください
• API キーが有効で、有効期限が切れていないことを確認してください
• ネットワークから API サーバーへの接続が許可されていることを確認してください

認証エラー

• API キーが設定に正しく指定されていることを確認してください
• API キーに必要な権限があることを確認してください
• 必要に応じて、ダッシュボードから API キーを再生成してください

タイムアウトエラー

• 大規模なコードベースを扱う場合は、API のタイムアウト設定を延長してください
• コードを小さな部分に分けて個別に分析することを検討してください
• ネットワーク接続が安定していることを確認してください

ライセンス

このプロジェクトは Apache License, Version 2.0 の下でライセンスされています。ライセンス全文は、リポジトリ内の LICENSE ファイルを参照してください。

ヘルプ

• ご不明な点やサポートが必要な場合は、お気軽に [email protected] までお問い合わせください。
• API キーは https://app.mcp.asterisk.so から取得できます