nexusfeed-mcp

Name: nexusfeed-mcp
Author: NexusFeed

PyPI version Python 3.12+ License: MIT

실시간 LTL 화물 유류 할증료 요율 및 미국 주별 ABC 주류 판매 면허 규정 준수 기록을 Model Context Protocol을 통해 AI 에이전트를 위한 정규화되고 검증 가능한 JSON 형태로 제공합니다.

데이터는 일반적인 LLM 브라우징으로는 접근이 어려운 운송업체 요금 페이지 및 주별 ABC 포털(JS 렌더링, CAPTCHA, 세션 상태 사용)에서 추출됩니다. 모든 응답에는 _verifiability 블록(추출 타임스탬프, 신뢰도 점수, 소스 URL)이 포함되어 있어 에이전트가 데이터를 사용하기 전에 품질을 평가할 수 있습니다.

도구

도구	설명
`ltl_get_fuel_surcharge`	ODFL, Saia, Estes, ABF, R+L, TForce, XPO, SEFL, Averitt의 주간 유류 할증료 % — DOE 디젤 가격 및 최대 5년치 이력 제공
`ltl_list_carriers`	운송업체 커버리지 메타데이터 (SCAC 코드, 업데이트 일정, 추출 방식)
`abc_search_licenses`	상호, 소유자 또는 주소로 CA, TX, NY, FL 면허 데이터베이스 검색
`abc_lookup_license`	주에서 발행한 면허 번호를 통한 특정 시점의 면허 상태 조회
`abc_list_states`	주별 커버리지, 지연 시간 및 CAPTCHA 요구 사항

Related MCP server: us-legal-mcp

워크플로우 프롬프트

프롬프트	설명
`freight_audit_workflow`	게시된 운송업체 요금표와 대조하는 다단계 LTL 송장 감사
`license_compliance_check`	유통업체 주문, 보험 계약 또는 가맹점 온보딩 전 규정 준수 확인

API 액세스 권한 얻기

RapidAPI를 통해 구독하여 X-API-Key를 받으세요. 프리미엄 플랜이 제공됩니다(일일 10회 요청 무료).

제품	RapidAPI 목록
LTL 유류 할증료	rapidapi.com/ladourv/api/ltl-fuel-surcharge-api
ABC 면허 규정 준수	rapidapi.com/ladourv/api/abc-license-compliance-api

설치

pip install nexusfeed-mcp
# or with uv/uvx (no install needed):
uvx nexusfeed-mcp

구성

export MCP_API_BASE_URL=https://api.nexusfeed.dev
export MCP_API_KEY=sk_live_your_key_here

실행 (stdio)

# LTL tools only — 3 tools, 1 prompt
nexusfeed-ltl

# ABC tools only — 3 tools, 1 prompt
nexusfeed-abc

# All tools — 5 tools, 2 prompts
nexusfeed-mcp

Claude Desktop 구성

LTL 유류 할증료 전용:

{
  "mcpServers": {
    "nexusfeed-ltl": {
      "command": "uvx",
      "args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],
      "env": {
        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
        "MCP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

ABC 면허 규정 준수 전용:

{
  "mcpServers": {
    "nexusfeed-abc": {
      "command": "uvx",
      "args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],
      "env": {
        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
        "MCP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

모든 도구:

{
  "mcpServers": {
    "nexusfeed-mcp": {
      "command": "uvx",
      "args": ["nexusfeed-mcp"],
      "env": {
        "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
        "MCP_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cline (VS Code) 구성

Cline 설정 → MCP Servers → Add Server manually를 엽니다:

LTL 전용:

{
  "nexusfeed-ltl": {
    "command": "uvx",
    "args": ["--from", "nexusfeed-mcp", "nexusfeed-ltl"],
    "env": {
      "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
      "MCP_API_KEY": "sk_live_your_key_here"
    }
  }
}

ABC 전용:

{
  "nexusfeed-abc": {
    "command": "uvx",
    "args": ["--from", "nexusfeed-mcp", "nexusfeed-abc"],
    "env": {
      "MCP_API_BASE_URL": "https://api.nexusfeed.dev",
      "MCP_API_KEY": "sk_live_your_key_here"
    }
  }
}

스트리밍 가능한 HTTP (Smithery / 원격 클라이언트)

서버	URL
LTL 도구	`https://api.nexusfeed.dev/mcp-ltl/`
ABC 도구	`https://api.nexusfeed.dev/mcp-abc/`

모든 요청 시 X-API-Key 헤더를 전달하세요. 서버 메타데이터 (인증 없음):

https://api.nexusfeed.dev/.well-known/mcp/server-card-ltl.json
https://api.nexusfeed.dev/.well-known/mcp/server-card-abc.json

검증 가능성

모든 도구 응답에는 다음이 포함됩니다:

"_verifiability": {
  "source_timestamp": "2026-04-05T09:00:00Z",
  "extraction_confidence": 0.97,
  "raw_data_evidence_url": "https://odfl.com/...",
  "extraction_method": "api_mirror",
  "data_freshness_ttl_seconds": 604800
}

규정 준수가 중요한 결정에 데이터를 사용하기 전 extraction_confidence >= 0.90이 필요합니다.
data_freshness_ttl_seconds 내의 source_timestamp는 데이터가 캐시에서 최신 상태임을 의미합니다.
raw_data_evidence_url은 표준 소스이며, 에이전트가 독립적으로 검증할 수 있습니다.

사용 예시

LTL 화물 송장 감사:

Use abc_search_licenses with state="CA" and trade_name="Total Wine" to check
current license status, then abc_lookup_license for the full record with suspension history.

유통업체 거래 전 주류 판매 면허 확인:

Use abc_search_licenses with state="CA" and trade_name="Total Wine" to check
current license status, then abc_lookup_license for the full record with suspension history.

문제 해결

증상	해결 방법
모든 호출에서 401 오류	`MCP_API_KEY`가 설정되지 않았거나 유효하지 않음
"Could not reach API server"	`MCP_API_BASE_URL`이 설정되지 않음 — `https://api.nexusfeed.dev`여야 함
TX 엔드포인트에서 503 반환	TX TABC는 서버 측에서 2Captcha 구성이 필요함; 대신 CA, NY 또는 FL 사용
`extraction_confidence` < 0.90	데이터 품질 저하 — `raw_data_evidence_url`을 통해 독립적으로 검증

라이선스

클라이언트 코드 (본 저장소): MIT. LICENSE를 참조하세요.

NexusFeed 백엔드 서비스 (https://api.nexusfeed.dev): 상업용. 위의 MIT 라이선스는 이 저장소의 Python 클라이언트 래퍼에만 적용됩니다. 유료 API 키가 필요하며 별도의 서비스 약관이 적용되는 데이터 서비스에 대한 권한은 부여하지 않습니다. 기업용 SLA 및 라이선스 문의는 ops@nexusfeed.dev로 연락하십시오.

nexusfeed-mcp

nexusfeed-mcp

도구

워크플로우 프롬프트

API 액세스 권한 얻기

설치

구성

실행 (stdio)

Claude Desktop 구성

Cline (VS Code) 구성

스트리밍 가능한 HTTP (Smithery / 원격 클라이언트)

검증 가능성

사용 예시

문제 해결

라이선스

Resources

Tools

Latest Blog Posts

MCP directory API