Skip to content
Back to search

AgentScan

AI protocol scanner — discover exposed MCP servers, A2A Agent Cards, and open LLM APIs in one command. 一条命令盘点 MCP、A2A Agent Card 和 LLM 开放接口暴露面。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/7anx--agentscan/badge.svg)](/listings/7anx--agentscan)

HTML

<a href="/listings/7anx--agentscan"><img src="/api/listings/7anx--agentscan/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # AgentScan
  2. [English](README_en.md) | 中文
  3. > 一条命令盘点 MCP、A2A Agent Card 和 LLM 开放接口暴露面。
  4. [![Go](https://img.shields.io/badge/Go-1.21+-00ADD8?logo=go)](https://go.dev)
  5. [![GitHub stars](https://img.shields.io/github/stars/7anX/AgentScan?style=social)](https://github.com/7anX/AgentScan/stargazers)
  6. [![License](https://img.shields.io/github/license/7anX/AgentScan)](LICENSE)
  7. 传统端口扫描器只告诉你"这里有个 HTTP 服务"。AgentScan 继续往下走一层:判断这个服务是不是 MCP、是不是 A2A Agent、是不是开放的 LLM 接口,并输出可用工具、Agent 能力、模型列表和认证状态。
  8. ## 能扫什么
  9. | 协议 | 识别内容 |
  10. | --- | --- |
  11. | MCP Server | Streamable HTTP、HTTP+SSE legacy、工具/资源/提示词列表、认证状态、需认证 MCP Server 的 OAuth 2.0 发现、蜜罐信号 |
  12. | A2A Agent | Agent Card、skills、interfaces、无认证 JSON-RPC 可达性 |
  13. | LLM 开放接口 | Ollama、vLLM、SGLang、TGI、llama.cpp、Xinference、LiteLLM、FastChat、LocalAI、LM Studio、LMDeploy 等 25 种推理框架 |
  14. ## 快速开始
  15. **Linux / macOS(从源码编译)**
  16. ```bash
  17. git clone https://github.com/7anX/AgentScan
  18. cd AgentScan
  19. go build -o agentscan .
  20. # 扫域名或 IP
  21. ./agentscan scan example.com
  22. # 扫内网段
  23. ./agentscan scan 192.168.1.0/24
  24. # 跳过端口扫描,直接验证已知 host:port
  25. ./agentscan scan -f targets.txt --skip-port-scan
  26. ```
  27. **Linux 预编译二进制(无需 Go 环境)**
  28. ```bash
  29. # amd64
  30. curl -L https://github.com/7anX/AgentScan/releases/latest/download/agentscan_linux_amd64.tar.gz | tar xz
  31. chmod +x agentscan && sudo mv agentscan /usr/local/bin/
  32. # arm64(树莓派、ARM 云服务器)
  33. curl -L https://github.com/7anX/AgentScan/releases/latest/download/agentscan_linux_arm64.tar.gz | tar xz
  34. chmod +x agentscan && sudo mv agentscan /usr/local/bin/
  35. ```
  36. **Windows**
  37. ```powershell
  38. go build -o agentscan.exe .
  39. .\agentscan.exe scan example.com
  40. ```
  41. ## 命令
  42. ```text
  43. agentscan scan # MCP + A2A + LLM 全协议扫描(最常用)
  44. agentscan mcp # 只扫 MCP
  45. agentscan a2a # 只扫 A2A Agent Card
  46. agentscan llm # 只扫 LLM 开放接口
  47. ```
  48. 常用参数:
  49. ```text
  50. -f, --file FILE 从文件读取目标(每行一个)
  51. -T, --threads N TCP 扫描并发,默认 500
  52. --timeout MS TCP 超时,默认 2000ms
  53. --skip-port-scan 输入视为已开放的 host:port
  54. --proxy URL socks5/socks4/https/http 代理
  55. --strict A2A 精确模式:只输出高置信 confirmed 卡片(默认召回优先,保留 probable / 疑似非 A2A)
  56. -o, --output FILE 写 JSON;A2A/LLM 自动写 _a2a.json / _llm.json
  57. -v, --verbose 显示探测详情
  58. ```
  59. ## 组合用法
  60. ```bash
  61. # masscan 发现端口,AgentScan 做 AI 协议识别
  62. masscan 10.0.0.0/8 -p 80,443,8000,8080,11434 --rate 100000 -oL open_ports.txt
  63. awk '/open/ {print $4 ":" $3}' open_ports.txt > targets.txt
  64. agentscan scan -f targets.txt --skip-port-scan
  65. # 测绘平台结果二次验证
  66. agentscan scan -f fofa_export.txt --skip-port-scan --mcp-threads 200
  67. ```
  68. ## 博客
  69. - [MCP 暴露面的安全问题](https://7anx.github.io/security-research/mcp-attack-surface/)
  70. - [A2A 暴露面的安全问题](https://7anx.github.io/security-research/a2a-attack-surface/)
  71. - [AgentScan 使用说明](https://7anx.github.io/agentscan/agentscan-use-cases/)
  72. - [AgentScan 工作原理](https://7anx.github.io/agentscan/agentscan-architecture/)
  73. ## 赞助商
  74. 感谢以下安全社区对本项目的支持:
  75. <table>
  76. <tr>
  77. <td align="center">
  78. <img src="docs/yunkunlab.jpg" alt="云鲲安全实验室" width="120"><br>
  79. <b>云鲲安全实验室</b>
  80. </td>
  81. </tr>
  82. </table>
  83. ## 社区
  84. 本项目在 [LINUX DO](https://linux.do) 社区开源推广。
  85. ## 免责声明
  86. 本工具仅面向合法授权的企业安全建设行为。使用前请确保已获得授权,符合当地法律法规,不对非授权目标扫描。作者不承担任何非法使用产生的后果。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.