Asterisk MCP Server

Asterisk MCP 服务

一个模型上下文协议（MCP）服务，为代码片段、代码库和代码变更验证提供安全扫描功能。

概述

Asterisk MCP 服务是一个中间件组件，可连接到 Asterisk 安全 API，对代码进行实时安全分析。它实现了模型上下文协议（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 漏洞扫描器 API
3. API 分析代码并返回安全问题
4. MCP 服务整理结果并将其返回给 IDE/编辑器
5. IDE/编辑器向用户展示安全分析结果

故障排除

连接问题

• 确认 API URL 正确且可访问
• 检查 API 密钥是否有效且未过期
• 确保网络允许连接到 API 服务

身份验证错误

• 确认配置中已正确设置 API 密钥
• 检查 API 密钥是否具有必要权限
• 如有需要，请从控制面板重新生成 API 密钥

超时错误

• 对于大型代码库，请增加 API 超时设置
• 考虑将代码拆分为较小部分，分别进行分析
• 检查网络连接是否稳定

许可证

本项目采用 Apache License, Version 2.0 许可。完整许可证文本请参阅代码仓库中的 LICENSE 文件。

获取帮助

• 我们随时为您提供帮助！如有其他问题或需要协助，请通过 [email protected] 联系我们。
• 请从 https://app.mcp.asterisk.so 获取 API 密钥