MCP Osint

mcp-osint

Claude Code的MCP服务器，提供对OSINT数据源的访问：

• 政府 -Data.gov、LegiScan、CourtListener、人口普查局
• 研究 -OpenAlex，语义学者，PubMed，CORE
• 企业 -SEC EDGAR（10-K，10-Q），FRED（经济数据）
• 合规 -开放制裁（制裁、政治公众人物）
• 新闻/知识 - GDELT， 维基数据
• 基础设施 -crt.sh（SSL证书、子域）
• 网络 -Firecrawl（使用HTML+markdown抓取URL）

设置

1.获取API密钥

所需密钥：

• LegiScan - legiscan.com/user/register
• 法庭听众 - 法庭听众.com/api
• 弗雷德 - fred.stlouisfed.org/docs/api
• 火爬 - firecrawl.dev

可选密钥（更高的速率限制）：

• Data.gov - api.data.gov/注册
• 人口普查 - census.gov/data/developers
• 核心 - core.ac.uk/services/api
• 开放 - opensanctions.org/api

免费（无密钥）：SEC EDGAR、GDELT、维基数据、crt.sh、OpenAlex、语义学者、PubMed

2.安装和构建

cd mcp-osint
npm install
npm run build

3.添加到克劳德代码

使用CLI：

claude mcp add -s user -t stdio mcp-osint \
  -e LEGISCAN_API_KEY=your-key \
  -e COURTLISTENER_API_KEY=your-key \
  -e FRED_API_KEY=your-key \
  -e FIRECRAWL_API_KEY=your-key \
  -- node /path/to/mcp-osint/dist/index.js

或者手动添加到MCP设置中(~/.claude/settings.json 或VS代码设置）：

{
  "mcpServers": {
    "mcp-osint": {
      "command": "node",
      "args": ["/path/to/mcp-osint/dist/index.js"],
      "env": {
        "LEGISCAN_API_KEY": "your-key",
        "COURTLISTENER_API_KEY": "your-key",
        "FRED_API_KEY": "your-key",
        "FIRECRAWL_API_KEY": "your-key",
        "POLITE_EMAIL": "you@example.com"
      }
    }
  }
}

工具

osint_search

搜索14个OSINT数据源。返回包含可用资源的结果。

示例：

"EPA air quality data California"       → Data.gov
"Michigan renewable energy bill 2024"   → LegiScan
"Brown v. Board of Education"           → CourtListener
"population by county Texas"            → Census
"machine learning medical diagnosis"    → OpenAlex/PubMed
"Apple 10-K filing 2024"                → SEC EDGAR
"GDP quarterly growth rate"             → FRED
"Russian sanctions oligarchs"           → OpenSanctions
"Ukraine conflict news"                 → GDELT
"microsoft.com subdomains"              → crt.sh

osin_preview

在获取之前预览资源的架构和示例数据。

osint_get

从资源ID或URL获取数据。自动处理网页、PDF和结构化数据。

按目标类型划分的行为：

示例：

osint_get target="https://example.com/article"
osint_get target="https://example.com/paper.pdf" output_path="./downloads/paper.pdf"
osint_get target="pubmed:paper:12345:abstract" question="key findings"

osint_list_来源

列出所有数据源及其配置状态。

环境变量

连接器

发展

npm install       # Install dependencies
npm run build     # Compile TypeScript
npm run dev       # Watch mode
npm start         # Run server

测试

# Test connector metadata and identifiers
npx tsx test/test-all-connectors.ts

# Test data retrieval (downloads files)
npx tsx test/test-data-retrieval.ts

# Test Firecrawl HTML+Markdown
npx tsx test/test-firecrawl.ts

# Run comprehensive MCP tool tests
npx tsx test/test-mcp-scenarios.ts

建筑

src/
├── index.ts              # MCP server entry point
├── types.ts              # Shared types
├── intent.ts             # Query parsing and routing
├── router.ts             # Connector selection
├── logger.ts             # Logging utility
├── cache.ts              # SQLite + file caching
├── retry.ts              # Retry with backoff
└── connectors/
    ├── base.ts           # Base connector class
    ├── data-gov.ts       # Data.gov/CKAN
    ├── legiscan.ts       # LegiScan
    ├── courtlistener.ts  # CourtListener
    ├── census.ts         # Census Bureau
    ├── openalex.ts       # OpenAlex
    ├── semantic-scholar.ts
    ├── pubmed.ts         # PubMed/NCBI
    ├── core.ts           # CORE
    ├── sec-edgar.ts      # SEC EDGAR
    ├── fred.ts           # FRED
    ├── opensanctions.ts  # OpenSanctions
    ├── gdelt.ts          # GDELT
    ├── wikidata.ts       # Wikidata
    ├── crt-sh.ts         # crt.sh
    └── firecrawl.ts      # Firecrawl

许可证

麻省理工学院