URLhaus MCP Server

这是一个全面的模型上下文协议（MCP）服务器，提供对 URLhaus 的访问，该项目由 abuse.ch 运营，收集并分享用于恶意软件分发的恶意 URL。此服务器使 AI 代理能够通过 URLhaus 数据库进行威胁情报研究和网络安全分析。

功能

此 MCP 服务器提供了以下工具来查询 URLhaus 数据：

URL 分析工具

• get_recent_urls: 获取 URLhaus 中最近的恶意 URL
• lookup_url: 获取特定 URL 的详细信息
• search_urls: 根据各种条件（主机、URL、标签或签名）搜索 URL

主机/域名分析工具

• lookup_host: 获取托管在特定主机/域名上的 URL 的信息

恶意软件分析工具

• lookup_payload: 根据其哈希值获取恶意软件负载的信息
• get_payloads: 获取 URLhaus 中最近的恶意软件负载
• get_urls_by_tag: 获取与特定恶意软件标签/家族相关的 URL
• get_urls_by_signature: 获取与特定恶意软件签名相关的 URL

安装

从 GitHub

1. 克隆仓库：

   git clone https://github.com/Cyreslab-AI/urlhaus-mcp-server.git
   cd urlhaus-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建服务器：

   npm run build
   

从 npm（即将推出）

npm install -g urlhaus-mcp-server

配置

将服务器添加到您的 MCP 设置配置中：

{
  "mcpServers": {
    "urlhaus": {
      "command": "node",
      "args": ["/path/to/urlhaus-mcp-server/build/index.js"]
    }
  }
}

由于 URLhaus 提供免费的公共 API，因此不需要 API 密钥或身份验证。

使用示例

获取最近的恶意 URL

{
  "tool": "get_recent_urls",
  "arguments": {
    "limit": 50
  }
}

查找特定 URL

{
  "tool": "lookup_url",
  "arguments": {
    "url": "https://suspicious-domain.com/malware.exe"
  }
}

根据主机搜索 URL

{
  1. "tool": "search_urls",
  2. "arguments": {
  3.     "search_term": "malicious-domain.com",
  4.     "limit": 100
  5. }
  6. }
  7. 
  8. ### 根据恶意软件家族获取 URL
  9. ```json
  10. {
  11.   "tool": "get_urls_by_tag",
  12.   "arguments": {
  13.     "tag": "emotet",
  14.     "limit": 50
  15.   }
  16. }
  17. ```
  18. 
  19. ### 查找恶意软件负载
  20. ```json
  21. {
  22.   "tool": "lookup_payload",
  23.   "arguments": {
  24.     "hash": "d41d8cd98f00b204e9800998ecf8427e"
  25.   }
  26. }
  27. ```
  28. 
  29. ## API 请求限制
  30. 
  31. URLhaus 有请求限制以防止滥用。如果您遇到请求限制，请等待一段时间后再进行额外请求。
  32. 
  33. ## 数据格式
  34. 
  35. 所有响应都包括：
  36. - `query_status`: API 查询的状态（"ok" 或错误消息）
  37. - `summary`: 结果的人类可读摘要
  38. - 与查询类型相关的数据（URL、负载等）
  39. 
  40. ## 关于 URLhaus
  41. 
  42. URLhaus 由 abuse.ch 运营，并提供：
  43. - 恶意 URL 的实时馈送
  44. - 关于恶意软件负载的信息
  45. - 与各种威胁情报平台的集成
  46. - 向安全研究人员和防御者免费开放
  47. 
  48. 如需更多信息，请访问：https://urlhaus.abuse.ch/
  49. 
  50. ## 开发
  51. 
  52. 要在开发模式下运行：
  53. ```bash
  54. npm run watch
  55. ```
  56. 
  57. 要检查服务器：
  58. ```bash
  59. npm run inspector
  60. ```
  61. 
  62. ## 贡献
  63. 
  64. 欢迎贡献！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
  65. 
  66. ## 许可证
  67. 
  68. 本项目根据 MIT 许可证发布 - 详情见 [LICENSE](LICENSE) 文件。
  69. 
  70. ## 致谢
  71. 
  72. - [URLhaus](https://urlhaus.abuse.ch/) 由 abuse.ch 提供免费威胁情报 API
  73. - [Model Context Protocol](https://modelcontextprotocol.io/) 提供 MCP 框架
  74. - [Cyreslab AI](https://github.com/Cyreslab-AI) 负责开发和维护
  75. 
  76. ## 支持
  77. 
  78. 如果您遇到任何问题或有任何疑问，请在 GitHub 上 [打开一个问题](https://github.com/Cyreslab-AI/urlhaus-mcp-server/issues)。