The Aleph MCP

Aleph MCP

Aleph MCP 是一个模型上下文协议（MCP）服务器，通过Aleph API为LLM提供强大的网络智能功能。将Claude Desktop连接到实时PTR记录、ASN数据、跟踪路由分析和网络监控。

🌐 实时API: thealeph.ai | 📖 完整文档: API文档

🚀 快速安装

方法1:NPM注册表（推荐）

# Once published to npm
npm install -g thealeph-mcp
thealeph-mcp --setup

方法2：从GitHub安装

# Install directly from GitHub repository
npm install -g https://github.com/NU-AquaLab/thealeph-mcp.git

# Setup Claude Desktop (interactive)
thealeph-mcp --setup

# Test everything works
thealeph-mcp --test-all

方法3：克隆并安装

# Clone the repository
git clone https://github.com/NU-AquaLab/thealeph-mcp.git
cd thealeph-mcp

# Install globally
npm install -g .

# Setup Claude Desktop
thealeph-mcp --setup

✅ 验证安装

安装后，重新启动Claude Desktop并询问：

“你们有什么工具？”

您应该看到列出了13个Aleph工具！然后尝试：

“检查Aleph系统的运行状况” “查询IP 8.8.8.8的PTR记录” “ASN 15169的正则表达式模式是什么？”

🛠️ 特性

🌐 网络智能工具

Aleph MCP提供了13个强大的网络分析工具：

监控工具（5）

1. 健康检查 -系统状态和可用性
2. 当前统计数据 -API最近N天的使用情况统计数据
3. 每日统计数据 -具体日期统计
4. 概要统计 -快速使用摘要
5. 出口统计 -导出监控数据（JSON/CSV）

ASN分析工具（5）

1. ASN分类 -ASN的分类数据
2. ASN正则表达式模式 -ASN的PTR解析模式
3. ASN提示 -地理和网络提示
4. ASN基础架构映射 -基础设施位置图
5. ASN提示映射 -基于提示的位置映射

PTR查询工具（2）

1. 查询PTR -具有网络智能的单PTR记录查询
2. 批量查询PTR -多个PTR查询（最多100个）

追踪路线工具（1）

1. 追踪路线映射器 -用网络智能丰富跟踪路由

📊 数据源

• PTR记录：使用地理智能进行反向DNS查找
• ASN数据：自主系统分类和模式
• 追踪路线分析：逐跳网络智能
• 监控：实时API使用情况统计
• API：生产部署 thealeph.ai

🔧 CLI命令

# Start MCP server (for Claude Desktop)
thealeph-mcp

# Interactive Claude Desktop setup
thealeph-mcp --setup

# Test API connection
thealeph-mcp --test

# Run full test suite
thealeph-mcp --test-all

# Show current configuration
thealeph-mcp --config

# Show help
thealeph-mcp --help

📋 需求

• Node.js：18.0.0或更高(下载)
• npm：最新版本（Node.js附带）
• Claude桌面版：支持MCP的最新版本
• 网络：连接互联网以访问The Aleph API

检查要求

# Verify you have the right versions
node --version  # Should be v18.0.0+
npm --version   # Any recent version
which thealeph-mcp  # Should show path after installation

🔧 配置和设置

自动配置（推荐）

# Interactive setup - detects your system automatically
thealeph-mcp --setup

此命令将：

• ✅ 自动定位您的Aleph MCP安装
• ✅ 验证安装是否正常工作
• ✅ 检测您的操作系统（macOS/Windows/Linux）
• ✅ 查找您的Claude Desktop配置文件
• ✅ 使用正确的绝对路径配置Claude Desktop
• ✅ 显示所有内容的确切安装位置

手动配置

如果自动设置不起作用：

1.查找您的Claude桌面配置文件

2.添加Aleph MCP配置

将以下配置添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "thealeph": {
      "command": "thealeph-mcp"
    }
  }
}

这将使用默认的Aleph服务器 https://thealeph.ai.

环境变量

# Set custom API URL (optional)
export THEALEPH_API_URL=https://thealeph.ai

# Windows PowerShell:
$env:THEALEPH_API_URL="https://thealeph.ai"

📖 使用示例

配置后，您可以使用Claude Desktop中的Aleph工具：

基本健康检查

“检查Aleph系统的运行状况”

PTR记录查询

“查询PTR记录中的IP地址8.8.8.8” “你能找到dns.google的哪些网络信息？”

批量PTR查询

查询这些IP:8.8.8、1.1.1.1和9.9.9.9的PTR记录

ASN分析

“谷歌的ASN 15169使用了哪些正则表达式模式？” “显示ASN 15169的基础架构映射”

追踪路线分析

“这是我的traceroute输出，用网络智能丰富它：\[粘贴traceroute\]”

网络研究

“Cloudflare的ASN 13335有哪些地理提示？” “比较ASN 15169（谷歌）和ASN 32934（元）之间的分类”

🐛 故障排除

安装问题

Claude桌面问题

调试命令

# Check what's actually installed
npm list -g thealeph-mcp

# Find installation path
which thealeph-mcp

# Test server directly
node $(npm root -g)/thealeph-mcp/src/server.js --version

# Validate Claude Desktop config
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | jq .

# Test API server
curl https://thealeph.ai/monitoring/health

日志文件

检查这些位置的错误日志：

有关更详细的故障排除，请参阅 docs/TROUBLESHOOTING.md.

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🤝 贡献

欢迎投稿！请查看我们的 贡献指南 了解详情。

📚 相关项目

• Aleph网络应用程序: thealeph.ai
• Aleph API文档: API文档
• 模型上下文协议: MCP规范

______________________________________________________________________

Aleph MCP -将网络智能引入会话式人工智能🌐✨