Asterisk MCP Server

🚀 Asterisk MCP 服務器

Asterisk MCP 服務器是一個提供代碼安全掃描功能的模型上下文協議（MCP）服務器，可用於分析代碼片段、代碼庫以及驗證代碼更改，為代碼安全保駕護航。

🚀 快速開始

Asterisk MCP 服務器是一箇中間件組件，連接到 Asterisk 安全 API，以實現即時代碼安全分析。它實現 Model Context Protocol (MCP)，為 Claude、Cursor、Cline、Windsurf 等 AI 助手提供安全掃描工具，使它們能夠分析代碼中的安全漏洞。

✨ 主要特性

• 代碼片段掃描：分析單個代碼片段中的安全漏洞。
• 代碼庫掃描：掃描多個文件，實現全面上下文覆蓋的安全問題檢測。
• 變更驗證：檢查聊天曆史中的代碼更改是否引入了安全漏洞。
• 漂亮的設置界面：通過圖形界面配置服務器。
• 靈活的傳輸協議：支持 stdio 和 SSE 傳輸協議。
• 詳細的日誌記錄：提供詳細日誌，可調節記錄 verbosity。

📦 安裝指南

運行 Asterisk MCP 服務器需要以下依賴：

• Python 3.10+
• pipx / uvx
• httpx
• mcp[cli]
• dearpygui（用於設置界面）

💻 使用示例

基礎用法

以下是配置運行 Asterisk MCP 服務器的示例：

{
  "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"
    }
  }
}

📚 詳細文檔

架構

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;

配置

API 服務器設置

• --host：指定綁定地址，默認為 0.0.0.0。
• --port：指定監聽端口，默認為 8000。

MCP 服務器設置

• logLevel：調節日誌等級，可選值有 DEBUG、INFO、WARNING、ERROR、CRITICAL，默認為 INFO。
• stdOut 和 stdErr：分別指定標準輸出和錯誤輸出的文件路徑。

可用工具

• 代碼片段掃描：分析單行或多行代碼中的安全問題。
• 代碼庫掃描：遍歷整個項目目錄，檢測潛在的安全漏洞。
• 變更驗證：比較新舊版本代碼，識別新增或修改的部分，並評估其對安全性的影響。

數據流

1. 用戶通過界面提交代碼片段或文件。
2. MCP 服務器接收請求並解析內容。
3. 請求轉發至 Asterisk 安全 API 進行深度分析。
4. 分析結果返回給 MCP 服務器。
5. MCP 服務器將結果格式化後呈現給用戶。

故障排除

連接問題

• 檢查網絡是否正常，確保目標服務器可達。
• 確認端口配置正確，並且沒有被防火牆阻擋。

認證錯誤

• 核對 API 接口的訪問權限和憑證信息。
• 確保請求頭中的認證信息完整無誤。

超時問題

• 增加超時設置，調整 API 請求的等待時間。
• 優化代碼掃描策略，減少不必要的分析步驟。

📄 許可證

項目遵循 MIT License，具體條款請參考 LICENSE 文件。

獲取幫助

如需技術支持或報告問題，請訪問 Asterisk 官方網站 或加入社區討論組。