Asterisk MCP Server

🚀 Asterisk MCP サーバー

コード断片、コードライブラリの分析やコード変更の検証を行うための、コードセキュリティスキャン機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

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

✨ 主な機能

• コード断片スキャン：単一のコード断片内のセキュリティホールを分析します。
• コードライブラリスキャン：複数のファイルをスキャンし、全面的なコンテキストをカバーしたセキュリティ問題の検出を行います。
• 変更検証：チャット履歴内のコード変更がセキュリティホールを引き起こすかどうかを確認します。
• 美しい設定画面：グラフィカルインターフェースを通じてサーバーを設定できます。
• 柔軟な伝送プロトコル：stdio と SSE 伝送プロトコルをサポートします。
• 詳細なログ記録：詳細なログを提供し、記録の詳細度を調整できます。

🔧 技術詳細

アーキテクチャ

flowchart LR
    IDE["IDE / コードエディタ"] <--> |MCP プロトコル| MCP["Asterisk MCP サーバー"]
    MCP <--> |HTTP/HTTPS| API["Asterisk 脆弱性スキャナー 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;

データフロー

1. ユーザーがインターフェースを通じてコード断片またはファイルを送信します。
2. MCP サーバーがリクエストを受け取り、内容を解析します。
3. リクエストが Asterisk セキュリティ API に転送され、深い分析が行われます。
4. 分析結果が MCP サーバーに返されます。
5. MCP サーバーが結果を整形してユーザーに表示します。

📦 インストール

必要条件

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

💻 使用例

基本的な使用法

{
  "mcpServers": {
    "asterisk-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "asterisk-mcp",
        "--host",
        "0.0.0.0",
        "--port",
        "8000"
      ],
      "stdOut": "/tmp/mcp/stdout.log",
      "stdErr": "/tmp/mcp/stderr.log",
      "logLevel": "INFO"
    }
  }
}

📚 ドキュメント

設定

API サーバー設定

• --host：バインドアドレスを指定します。デフォルトは 0.0.0.0 です。
• --port：リッスンポートを指定します。デフォルトは 8000 です。

MCP サーバー設定

• logLevel：ログレベルを調整します。選択肢には DEBUG、INFO、WARNING、ERROR、CRITICAL があり、デフォルトは INFO です。
• stdOut と stdErr：それぞれ標準出力とエラー出力のファイルパスを指定します。

利用可能なツール

• コード断片スキャン：単行または複数行のコード内のセキュリティ問題を分析します。
• コードライブラリスキャン：プロジェクトディレクトリ全体を走査し、潜在的なセキュリティホールを検出します。
• 変更検証：新旧のコードバージョンを比較し、新たに追加または変更された部分を識別し、それがセキュリティに与える影響を評価します。

トラブルシューティング

接続問題

• ネットワークが正常であることを確認し、ターゲットサーバーに到達可能であることを確認します。
• ポート設定が正しいことを確認し、ファイアウォールによってブロックされていないことを確認します。

認証エラー

• API インターフェースのアクセス権限と認証情報を確認します。
• リクエストヘッダー内の認証情報が完全かつ正しいことを確認します。

タイムアウト問題

• タイムアウト設定を増やし、API リクエストの待機時間を調整します。
• コードスキャン戦略を最適化し、不要な分析ステップを削減します。

📄 ライセンス

このプロジェクトは MIT License に従っています。詳細な条項については LICENSE ファイルを参照してください。

ヘルプの取得

技術サポートが必要な場合や問題を報告する場合は、Asterisk 公式サイト にアクセスするか、コミュニティディスカッショングループに参加してください。