Alpha Mountain MCP

alphaMountain MCP服务器

MCP（模型上下文协议）服务器 阿尔法山.ai API，提供威胁情报、URL分类和域情报工具。

特性

此MCP服务器将以下alphaMountain API端点作为工具公开：

URL威胁情报

• get_threat_score -获取单个URL的威胁评分
• get_threat_scores -获取多个URL的威胁分数

URL分类

• get_categories -获取单个URL的类别
• get_categories_batch -获取多个URL的类别

领域情报

• get_hostname_intelligence -获取域/主机名的全面情报数据

动态

• get_threat_feed_json -获取JSON格式的威胁评级提要
• get_category_feed_json -获取JSON格式的分类提要
• get_popularity_feed_json -获取JSON格式的流行度排名提要

会计

• get_quota -获取端点的剩余配额
• get_license_info -获取详细的许可证和服务信息

支持

• submit_dispute -提交URI争议
• get_dispute_status -获取争议状态

先决条件

• Python 3.7+
• alphaMountain API密钥 - 申请免费试用密钥

安装

1.克隆存储库

git clone https://github.com/ZuuuSSzz/alphaMountain-MCP
cd alphaMountain-MCP

2.创建虚拟环境（推荐）

python -m venv venv
source venv/bin/activate    # Linux/macOS
venv\Scripts\activate      # Windows

3.安装依赖项

pip install -r requirements.txt

配置

设置API密钥

您可以通过以下方式之一设置alphaMountain API密钥：

1. 环境变量（建议单独使用）

   export ALPHAMOUNTAIN_API_KEY="your-api-key-here"

1. 在MCP配置文件中（建议用于Cursor/Claude桌面）

- 看 与Cursor/Claude桌面集成 下方部分

1. 命令行参数

   python alphamountain_mcp.py --api-key "your-api-key-here"

1. 传递给单个工具 -每个工具都接受一个可选 api_key 参数

用法

运行MCP服务器

使用SSE传输（默认）

python alphamountain_mcp.py --mcp-host 127.0.0.1 --mcp-port 8081 --transport sse

使用stdio传输

python alphamountain_mcp.py --transport stdio

命令行选项

• --mcp-host：运行MCP服务器的主机（默认值： 127.0.0.1，仅用于SSE）
• --mcp-port：运行MCP服务器的端口（默认值： 8081，仅用于SSE）
• --transport：传输协议- sse 或 stdio （默认值： sse)
• --api-key：alphaMountain API键（重写环境变量）

示例用法

获取URL的威胁评分

# Using the MCP tool
result = get_threat_score(
    uri="https://google.com/",
    scan_depth="low"
)
# Returns: {"version": 1, "status": {"threat": "Success"}, "threat": {"score": 1.10, ...}}

获取多个URL的类别

result = get_categories_batch(
    uris=["https://google.com/", "https://example.com/"]
)

获取域智能

result = get_hostname_intelligence(
    hostname="google.com",
    sections=["popularity", "dns", "whois"]
)

检查配额

result = get_quota(endpoint="threat")
# Returns: {"remaining": 8739, "key_expiry": "2022-12-31T00:00:00.000Z", ...}

与Cursor/Claude桌面集成

要将此MCP服务器与Cursor或Claude Desktop一起使用，请将其添加到MCP配置文件中：

对于光标

1. 打开或创建 ~/.cursor/mcp.json （或 %APPDATA%\Cursor\User\mcp.json 在Windows上）

1. 添加以下配置（调整路径以匹配您的安装）：

{
  "mcpServers": {
    "alphamountain": {
      "command": "/path/to/alphamountain/venv/bin/python",
      "args": [
        "/path/to/alphamountain/alphamountain_mcp.py",
        "--transport",
        "stdio"
      ],
      "env": {
        "ALPHAMOUNTAIN_API_KEY": "your-api-key-here"
      }
    }
  }
}

注： 替换 /path/to/alphamountain 使用克隆此存储库的实际路径。

适用于克劳德桌面

1. 打开或创建MCP配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json

1. 为Cursor添加与上述相同的配置

1. 重新启动Cursor/Claude Desktop以使更改生效

当应用程序启动时，服务器将自动启动，工具将在您的MCP客户端中可用。

API 文档

有关API的详细文档，请参阅 alphaMountain API文档 或参考 swagger.yaml.txt 此目录中的文件。

错误处理

服务器处理常见的API错误：

• 401：未经授权（许可证无效）
• 429：配额已用尽（检查 X-Quota-Next-Reset 头球
• 498：API密钥过期
• 4xx/5xx：其他HTTP错误

所有错误都会被记录下来，并作为异常情况以描述性消息的形式提出。

许可证

此MCP服务器按原样提供。alphaMountain API服务有自己的条款和条件。

支持

对于以下问题：

• 此MCP服务器：在存储库中打开问题
• 阿尔法山API：联系方式 阿尔法山支持