노동시장 인텔리겨컨 — 원격 MCP 서버

미국 노통통계칭(BLS)과 FRED(세인트루이스 연방은항)의 데이타를 Clau드에 커스텀 커넥터로 더로출하는 읽기 전용 원격 MCP 서벌입니다. 오직 직업 및 노동시장 연규를 위함 — 고용 사항, 실업, 일자리 공석, 채용, 퇴사, 임금, 직업 전망, 산업 비교.

Cloudfare Workers에서 실행. 비요: 월 $0 /월 (Cloudflare 무요 계층).

아디론 구현 계획을 기반으로 증분 히 개발하되 — 이 코드베이스에 참조되는 모든 BLS 및 FRED 을드포엔트, 시리즈 ID, 그리고 데이터 형식의 폰란 사공은 구현 적전애 실제 라이브 API까지 확인되었습니다(문서에서만 조치했 것은 아니아) .

상태

10개 구현 체크리스트가 완료되고 배포된 Cloudflare Worke전 대비 라이브 검증을 완료. 89개 anddit 테스트, 클린 타입 체크, 전 테스트 실 데이터로 확인 완료.

Claude에 더하기

1. Claude에서 설정 → 커넥터 → 커스텀 커넥터 추가합니다.

2. 원격 MCP 서버 URL: https://<your-worker>.<your-subdomain>.workers.dev/mcp/<MCP_PATH_TOKEN> — 이 URL은 자격증으로 취급하십시오. 토큰만 유이한 인가이기 때문입니다.

3. OAuth 고객 Client ID / 시커트: 둘 다; 이 서버는 인증이 없습니다 — 비밀 경로 자체는 자격증 진이며, Claude는 인증 없는 원격 MCP 서버를 기본 저장함.

4. 전송: Streamable HTTP(SSE는 레거시 백업 방식).

사용 가능한 (16)

저수준 소스 도구 — BLS/FRED에 대한 지kns하게, 신분히투과

Can 도구 —구성 and high-quality 분석

| 측정 협정 study(직 넎 집접) | 분석_고일 시장 추이 | 한 개 BLS/FRED 시에즈의 매일 및 CAGR | | 배고시_고용_시니즈 | 두 개*을 |10개 BLS/ED series(s현)를 널면 직각으로 함께 | | 분석_업무_시장_조건 | 시고급: 불출年사기, 급직자, 직업자, 하고자, 고용자 — 각 이/12개월 저변 | | 전체_산업_고용 장기 BLS 취직 전망 시전... | |직|업_전망_value대 | BLS 취업 전망 full data for 취업 번직(취업, 취직, 임금) | |동|비교_적업 |한 개의 BLS 전화 안에서 2-20 개의 생에 ho서 | 고|재|고용추이| 직정한 전임금 척도 (기본: 평 시장 동급) 비용자료 | |텍스트 등 | 통해 크게 접 |공급 BLS/FRED 터 제한 표 | default(프로| |ping` | 연결테스트트 트 도구

모든 도구는 readOnlyHint: true이며 자동 데스트에 의해 보장됩니다 (test/unigo/server.test.ts). 상태를 바는 도구가 없고, 호출자가 제공하는 URL을 가져오는 도구가 없습니다..

각 소스 출처 실제 제공 내용

라이브 API에서 확인한 것이지 문서에서 추측한 것이 아닌 것:

프레드(FRED)는, 넓은 매크로 천텍스트(국내 총생산, 금리, 경기침체 지표), 단위 변환, 그리고 리얼한 풀텍스트 시리즈 검색을 제공함. 또한 많은 BLS 시리즈(UNRATE, PAYEMS, JOLTS 중심)를 업로드합니다 — 그래서 BLS보다 개월 패턴 가 없어도 노동의 최신 모양을 볼 수.

BLS는 작업 관련 모든 것에 대한 갖은 것 취업 예측(EPF) — 전망/공개/임금 및 OEWW (임금 조사)에 있 — 전체 BLS 주관, FRED는 이 직업 고용 네트워크를 제공하지 않음.

OEWS는 API에 의한 역사가 없음 — 모든 series가 전달해 열려 있는 하나의 해가 확정됨 — 30년간 요청시 결과 9개 "데이터 없음" 및 한 개 데이텀만 반환. 취업 임금 추이는 농 API에 없음; 대신 get_occupation_outlook을 사용해서 신한해의 중윗값 임금 차트 참조.

취업 전망은 시계열이 아님 — 기본 연도 + 향후 연도(현재 ~10후연) & 최최 2번 업데이트 됩니다.

연간 채용 수치는 대체 수요를 잠음 (직장을 떠나는, 나가는 인원) — 단순 고용 성장만이 아님.

BLS 확장적인 시리즈 검색 API는 없음. 문서 검색의 경우 BLS 내부 파일 시리즈 및 빌드 검층된 사전 찰조, 그 것들이 아닌 code가 아님이 아니라, 사용자 문서에서 체계됩니다. search_indicators처럼 데이터 계열을 검색하고 search_occupations`도 같이 맇닌.

저자 표기

시스가 파생한 모든 응답에는 검색시간과 BLS의 요청사항 그대로: "BLa.gov은 BLS.gov에서 데이터를 회출한 후 그 데이터에서 파생된 데이터 또는 분석 결과에 대해 보증할 수 없습니다." FRED데 응답은 그 출처를 자체 표시합니다.

서버가 계산하는 모든 것은%(바꾸기, CAGR, 월간 변화)는 별도의 computedByServer 필드로 반환하고, 공식 BLS 또는 FRED 통계라고 제시하지 않습니다. 도구 지침은 응답 시 둘 다를 보전하는 것으로 Claude에게 지시합니다.

보안 모또

• 읽 전용. 어떤 도구도 상태 전환하거나 고객체 공급 UR을 가져오지 못합니다.

• 보호 경로 인증. 엔드포인트 /mcp/<256-bit 토큰>입니다. Claude의 커넥 UI는 URL만 받고 사용자 지정 헤더는 받지 않으므로, 자격 증명이 경로에 있습니다. 비교는 SHA-256 다이제스트 방식으로 정시간에 이니다. 모든 실패(틀큰이 틀름,틀큰이 없но, 노출)는 다어일 404 리턴 — 추측 없암.

• 수신 속도 제한. ~60요청/분/IP (cf-connecting-ip, Cloudflare 제공, 클라언트에 위조 소인) — 인증 전에 확인되므로 과부하 토큰 비교 CPU 낭비 없습니다. KV 바이크; KV가 접하지 않우면 오 (허용).

• 출지 BLS 예산 보호. 기본적으로 BLS 드 500/일 등록 키 예산의 45 0 내에서 회로 분리 — 소진된 경우 그 백엣지 요청 전에 호출을 실패하여 무한 루프가 원본 할당량을 잠식 방지.

• 비밀은 서버를 떠나지 않음. BLS_API_KEY, FRED_API_KEY, MCP_PATH_TOKEN은 Worke r 시크릿으로만 저장 — 시용자 응답에 반환하거나 기록되지 않습니다. src/lib/log/ging.ts 리는 알려진 시크릿 값과 api_key=/registrationkey= 패턴을 모든 로그 레코드에서 제거합니다. 이 동작 자체도 단위 테스트로 검증됩니다.

  • 제한 고지: Cloudflare 자체의 플랫폼 로그(및 wrangler tail)는 전체 요청 URL을 기록하며 경로 토큰도 포함합니다 — application 코드가 제어할 수 없는 부분입니다. 원시 로그를 공개하지 마세요; 만약 공개했다면 토큰과 새 URL을 다시 붙여넣으세요.

캐시

Workers KV, tw이 겹 : 최신 항목 (아래 TTL) +의 모든 성공에 함께 기록된 "35일 부백업". 대응 호출이 실패하거나 BLS 예산 소면 및 새로움 DB 시점 이전에도 스테일 백업이 반환되며 — 이는 limitations 필드에 구체적으로 표시하여, 구버전 데이터가 현재 데이터라고 표현하지 않습니다.

기 키는 도구 이름과 그 인자에서만 파생습니다 — 환변수나 시크릿로부터 없않니다 — ี่키 마텸에 시크릿정보로 었출 수 없습다.

프로젝트 구조

src/
  index.ts               Worker entry: routing, auth, rate limiting
  server.ts               MCP server construction + tool registration
  env.ts                  Env typing + secret names
  errors.ts                Typed error hierarchy (network/timeout/429/5xx/BLS-200-with-error-body)
  sources/
    http.ts               Shared fetch: timeout, retry/backoff
    bls.ts                BLS v2 client
    fred.ts               FRED client
  catalog/
    occupations.json      1,113 SOC occupations -> EP series ID (build-generated, validated)
    industries.json        423 EP industries -> series ID (build-generated, validated)
    indicators.ts           ~13 curated headline indicators (individually live-verified)
    search.ts               Shared token-matching + relevance-ranking search
  tools/
    source/                Thin passthrough tools
    research/               Composed analysis tools
  lib/
    cache.ts               Workers KV two-tier cache
    ratelimit.ts             BLS daily budget guard + inbound per-IP limiter
    envelope.ts              Response envelope: citations, timestamps, disclaimers
    stats.ts                 Deterministic trend math
    logging.ts                Structured logs with secret redaction
scripts/
  build-catalog.ts          Regenerates + validates the occupation/industry catalog
test/
  unit/                    Mocked, run on every `npm test`
  live/                    Real API calls, opt-in via `npm run test:live`

Hard 로컬 개발

npm install
cp .dev.vars.example .dev.vars   # fill in real keys for local testing
npx wrangler dev --port 8787
npm test                          # unit suite (mocked, no network)
npm run typecheck
npm run build:catalog              # regenerate the occupation/industry catalog from BLS's own flat files

실데 BLS/현지 데이터로 검증하기 (키를 커밋/로숖그하 않음):

BLS_API_KEY=your_key FRED_API_KEY=your_key npm run test:live

배포

npx wrangler login
npx wrangler kv namespace create CACHE   # one-time; paste the resulting id into wrangler.toml
npx wrangler secret put BLS_API_KEY
npx wrangler secret put FRED_API_KEY
npx wrangler secret put MCP_PATH_TOKEN     # generate with: openssl rand -hex 32
npx wrangler deploy
curl https://<your-worker>.<your-subdomain>.workers.dev/health

시크릿트와 KV는 wrangler deploy에서도 유지됩니다 — 한번만 설정하면 됩니다.

논라된 아한계정

• 고용 전망/조사는 단일 참조년월 스네샷샷 — 시계열 아님. 모든 도구는 이 점을 명확히 감지하여 보고함 (trevend: null+ 설명)이지 한 개 데이 포인트로 추이를 지어내지 않.

• BLS 고용 전망의 산업 코드와 월간 CES 부문 고용 시계열 사이의 검중된 연결 없음(분류 체계 상이). analyze_industry_employ는 장기 전망만 제공 — 월간 산업 고용은 fred_search_series와 analyze_labor_memploy_trend를 합쳐서 사용.

• SOC 직업 코드는 고용 전망 버전 간 변경딤 — 빈전사이 리밌 재구축 간 직업의 비교는 신안 못함.

• 발의 속도제한은 best-effort 고정-음직카은터(동시동의 일반리 can 있) → 소량 개인 커넥터의 타당한 trade- of이지, 정밀 보증은 아님.