us-govdata-mcp

미국 정부 데이터용 MCP 서버 — Claude, Cursor 또는 모든 Model Context Protocol 클라이언트에서 건축 허가, 연방 계약 기회(SAM.gov), 전국 의료 제공자 등록부(NPI/NPPES)를 검색할 수 있습니다.

세 데이터 소스 모두 공식 정부 발행 자료(도시 오픈데이터 포털, SAM.gov 공개 추출물, CMS NPPES API)입니다 — HTML 스크래핑, 로그인, 취약한 선택자가 필요 없습니다. 핵심 작업은 사용자 본인의 Apify 계정에서 실행되는 세 개의 프로덕션 Apify 액터가 수행합니다.

30초 만에 사용해보기 — 계정도, 요금도 없이

API 토큰이 필요한지 결정하기 전에, 토큰 없이 실행해보세요:

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_DRY_RUN": "1" }
    }
  }
}

이것이 전체 설정입니다. 드라이런 모드에서는 모든 도구가 실제 샘플 레코드와 전송되었을 Apify API 요청을 반환하므로 — 계정을 만들거나, 토큰을 붙여넣거나, 비용을 지출하지 않고도 데이터의 실제 형태를 확인하고, 에이전트가 도구를 올바르게 호출하는지 확인하고, 각 도구 설명에 포함된 가격 정보를 읽을 수 있습니다.

에이전트에게 "이번 달 오스틴에서 발급된 50만 달러 이상 건축 허가를 찾아줘" 같은 질문을 해보고 엔드투엔드 도구 호출을 확인하세요. 실제 데이터가 필요할 때는 APIFY_DRY_RUN 줄을 삭제하고 APIFY_TOKEN을 추가하세요(아래 참조).

Related MCP server: DOL WHD MCP

도구

* 정직한 가격 공개: 이 도구들은 CBLU가 게시한 유료, 결과당 지불 방식의 Apify 액터를 실행합니다. Apify 계정에는 실제로 반환된 레코드에 대해서만 요금이 청구됩니다 — 구독료나 시작 수수료는 없습니다. 모든 도구는 호출당 기본 25개 결과를 반환하므로, 일반적인 호출 비용은 1센트 미만입니다(허가 25건 ≈ $0.13; 계약 공고 25건 ≈ $0.10; 제공자 25건 ≈ $0.05). Apify 무료 요금제에는 월별 플랫폼 크레딧이 포함되어 있어 이 도구들을 무료로 간편하게 사용할 수 있습니다. 전체 가격 정보가 포함된 액터 페이지:

• US Building Permits Scraper

• SAM.gov Contract Opportunities Scraper

• NPI Registry Scraper

빠른 시작

1. Apify 토큰 받기(무료, 약 2분 소요)

1. https://console.apify.com/sign-up에서 가입하세요(무료 요금제 사용 가능).

2. https://console.apify.com/settings/integrations에서 API 토큰을 복사하세요.

서버는 토큰 없이도 시작되어 도구 목록을 표시합니다 — 토큰은 도구가 실제로 호출될 때만 필요합니다.

2. MCP 클라이언트에 서버 추가하기

Claude Desktop (claude_desktop_config.json → 설정 → 개발자 → 구성 편집):

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": {
        "APIFY_TOKEN": "your_apify_token_here"
      }
    }
  }
}

Claude Code:

claude mcp add us-govdata -e APIFY_TOKEN=your_apify_token_here -- npx -y github:CBLU2005/us-govdata-mcp

Cursor / Windsurf / 기타 MCP 클라이언트 (Claude Desktop과 동일한 형식):

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_TOKEN": "your_apify_token_here" }
    }
  }
}

로컬 클론에서:

git clone https://github.com/CBLU2005/us-govdata-mcp.git
cd us-govdata-mcp
npm install && npm run build
# then point your client at: node /path/to/us-govdata-mcp/dist/index.js

Docker:

docker build -t us-govdata-mcp .
docker run -i --rm -e APIFY_TOKEN=your_apify_token_here us-govdata-mcp        # stdio
docker run --rm -p 3000:3000 -e APIFY_TOKEN=... us-govdata-mcp --http 3000    # Streamable HTTP

3. AI 에이전트에게 다음과 같은 질문을 해보세요

• "이번 달 오스틴에서 발급된 50만 달러 이상 신축 건축 허가를 계약자 이름과 함께 찾아줘."

• "마감일이 오늘 이후인 활성 중소기업 우선 사이버보안 제안요청서가 있으면 계약 담당관 이메일을 포함해서 알려줘."

• "마이애미 지역(우편번호 331)의 치과의사 목록을 진료소 전화번호와 함께 보여줘."*

전송 방식

• stdio (기본값) — 데스크톱 MCP 클라이언트가 사용: us-govdata-mcp

• Streamable HTTP — 상태 비저장 엔드포인트 POST /mcp, 상태 확인 GET /healthz: us-govdata-mcp --http 3000 (또는 MCP_HTTP_PORT=3000 설정)

환경 변수

작동 방식

각 도구는 인수(zod)를 검증하고, 액터 입력을 구성한 후, 토큰을 사용하여 Authorization: Bearer 헤더(URL에는 절대 포함되지 않음)를 통해 Apify API의 run-sync-get-dataset-items 엔드포인트를 호출합니다. 액터는 사용자 계정으로 Apify 플랫폼에서 실행되며, 결과 데이터셋 항목이 도구 결과로 직접 반환됩니다. 이 서버는 상태를 유지하지 않으며 데이터를 단순히 전달하는 것 외에는 어떤 데이터도 보지 않습니다.

개발

npm install
npm test          # builds + runs the full smoke suite (introspection, tokenless
                  # error path, dry-run request construction, HTTP transport)

테스트 스위트는 Apify 계정이나 네트워크가 필요 없습니다 — APIFY_DRY_RUN=1을 사용합니다.

관련 링크

• 모든 CBLU 액터가 있는 Apify Store 프로필: https://apify.com/cblu

• Model Context Protocol: https://modelcontextprotocol.io

라이선스

MIT © CBLU