lachydotmcg/argus-mcp

# argus-mcp 从 Claude Code 和其他 MCP 客户端运行 [Argus](https://github.com/lachydotmcg/argus)。 Argus 是一款防御性的自我 OSINT 扫描器。`argus-mcp` 将其封装为一个小型[模型上下文协议](https://modelcontextprotocol.io/)服务器，以便 Agent 能够响应如下请求：  ## 为什么？ 安全和隐私工作现在通常在 Agent 会话中进行。如果没有 MCP，你必须离开对话、手动运行 Argus、将结果复制回来，然后让模型去解释它们。 有了 `argus-mcp`，Claude Code 或任何 MCP 客户端都可以直接调用 Argus： - 在 Argus 精选的平台列表中枚举用户名 - 运行基于 Gemini 网络情报的全面防御性足迹扫描 - 生成现有的 Argus HTML 和 JSON 报告 这个仓库有意与 Argus 分开。Argus 负责扫描；而这个包仅仅是 MCP 桥梁。 ## 负责任的使用 Argus 用于检查你自己的数字足迹，或者你明确被授权调查的目标。请勿在未经同意的情况下使用它来跟踪、骚扰、监视或分析他人。 扫描工具需要 `authorized=true`，因此客户端和用户必须明确表达该意图。 ## 工具 | 工具 | 功能 | | --- | --- | | `enumerate_username` | 在 Argus 平台中检查一个用户名，并返回找到的资料。 | | `run_full_scan` | 运行枚举、可选的用户名变体、Gemini grounding、可选的 Google Custom Search、可选的 HIBP 以及风险摘要。 | | `generate_report` | 根据扫描结果生成 Argus 的 HTML 和 JSON 报告文件。 | ## 快速开始 将此 MCP 服务器和 Argus 安装到同一个 Python 环境中： ``` git clone https://github.com/lachydotmcg/argus-mcp.git cd argus-mcp python -m venv .venv source .venv/bin/activate pip install -e . pip install "git+https://github.com/lachydotmcg/argus.git" ``` Windows PowerShell： ``` git clone https://github.com/lachydotmcg/argus-mcp.git cd argus-mcp python -m venv .venv .\.venv\Scripts\activate pip install -e . pip install "git+https://github.com/lachydotmcg/argus.git" ``` 在本地开发期间，你可以改为从同级检出中安装 Argus： ``` pip install -e ..\argus ``` 如果你不想将 Argus 安装到同一环境中，请将 `ARGUS_SOURCE_PATH` 设置为 Argus 源码检出路径。 ## Claude Code 安装后复制粘贴以下内容： ``` claude mcp add \ --env GEMINI_API_KEY=your-gemini-key \ --transport stdio \ argus \ -- /absolute/path/to/argus-mcp/.venv/bin/python -m argus_mcp.server ``` Windows PowerShell： ``` claude mcp add ` --env GEMINI_API_KEY=your-gemini-key ` --transport stdio ` argus ` -- C:\absolute\path\to\argus-mcp\.venv\Scripts\python.exe -m argus_mcp.server ``` 如果 Argus 没有安装在同一环境中，请添加 `ARGUS_SOURCE_PATH`： ``` --env ARGUS_SOURCE_PATH=/absolute/path/to/argus ``` 然后询问 Claude Code： ``` Use Argus to enumerate the username "example" across platforms. I am authorized to scan this username. ``` ## API Keys `enumerate_username` 不需要 API key。 `run_full_scan` 可以使用： - `GEMINI_API_KEY` 或 `GOOGLE_API_KEY` 用于基于 Gemini 的网络情报 - `GOOGLE_CSE_KEY` 和 `GOOGLE_CSE_CX` 用于执行精确的 Google Custom Search dork - `HIBP_API_KEY` 用于 Have I Been Pwned 的泄露检查 ## 开发 ``` PYTHONPATH=src python -m unittest discover -s tests python -m compileall src tests ``` MCP SDK 固定在稳定的 `mcp` v1.x 版本，因为上游 Python SDK 文档目前将 v2 标记为 alpha 版。

标签：AI智能体, ESC4, MCP服务器, OSINT, Python, 实时处理, 数字足迹扫描, 无后门, 逆向工具