使用说明
osint-mcp
用于OSINT工作流的MCP服务器,由以下本地知识提供支持 writeups/.
实施堆栈: hono + @hono/mcp.
从npm安装
npm i -g osint-mcp
或者直接运行它:
npx -y osint-mcp
设置
bun install
bun run dev
Git挂钩
安装存储库挂钩:
bun run hooks:install
现行政策:
pre-commit跑bun run typecheck仅
Codex MCP(一个命令)
使用单个命令在Codex中注册此服务器:
codex mcp add osint-mcp-local -- bun --cwd "$(pwd)" run mcp:stdio
如果在此存储库之外运行该命令,请替换 "$(pwd)" 这个项目的绝对路径。
如果你使用已发布的npm包:
codex mcp add osint-mcp -- npx -y osint-mcp
验证注册:
codex mcp list
启动模式
# HTTP mode (default)
bun run dev:http
bun run start:http
# Command mode (stdio transport for MCP clients)
bun run dev:stdio
bun run start:stdio
bun run mcp:stdio
构建/启动
bun run build
bun run start
检查
bun run typecheck
bun run test
启动后:
GET /healthALL /mcp
实施MCP工具
search_past_writeups- 全文搜索完毕
writeups/**/README.md并返回顶部匹配提示
- 全文搜索完毕
list_frequent_domains_in_writeups- 从报告中聚合频繁引用的域
duckduckgo_search_api- 查询DuckDuckGo即时应答API(不需要API密钥)
wayback_cdx_lookup- 查询Wayback Machine CDX API快照(支持
timeoutMs用于繁重的通配符查询)
- 查询Wayback Machine CDX API快照(支持
jina_fetch_url- 通过获取页面文本
https://r.jina.ai/
- 通过获取页面文本
twstalker_profile_lookup- 通过以下方式获取Twstalker个人资料时间线
r.jina.ai并提取最近的帖子片段
- 通过以下方式获取Twstalker个人资料时间线
capsolver_create_and_poll- 创建一个CapSolver任务并轮询直到完成(
apiKey作为输入传递)
- 创建一个CapSolver任务并轮询直到完成(
yandex_image_search_scrape- 在没有API键的情况下抓取Yandex图像搜索结果
archive_today_lookup- 获取archive.today/archive.md时间图条目
domain_recon_bundle- 捆绑DNS/RDAP/crt.sh/wheis/可选Shodan查找
extract_metadata_from_media- 从本地或远程媒体(exiftool/ffprobe/exifr)提取元数据
