제품 설명을 공식 HS 코드로 분류하고 정부 관세율표를 사용하여 공급업체가 제공한 코드를 검증합니다.
다른 이름 OjasKord/hs-code-classifier-mcp-server, hs-code-classifier-mcp-server, hs-code-classifier-mcp
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.26
- 마지막 커밋
- 2026년 9월 7일
- 라이선스
- MIT
HS Code Classifier MCP란?
제품 설명을 공식 HS 코드로 분류하고 정부 관세율표를 사용하여 공급업체가 제공한 코드를 검증합니다.
프로젝트 README에서 생성된 요약
HS Code Classifier MCP server 정보
이 MCP server는 물류 및 무역 전문가를 위해 제품 설명을 공식 HS 코드로 분류하고 공급업체 데이터를 검증하는 기능을 제공합니다. HSPing API를 통해 USITC, Singapore Customs, CBSA, Australia Border Force와 같은 기관의 공식 정부 관세율표에 연결합니다. 사용자는 npx를 통해 로컬에서 실행하거나 Claude Desktop, LangChain 또는 OpenAI Agents SDK를 사용하여 호스팅된 HTTP 버전에 연결할 수 있습니다.
개발자는 hs_classify_product 도구를 사용하여 설명을 통관 신고 또는 관세 계산을 위한 코드로 변환할 수 있으며, 이는 월 10회 호출로 제한되는 무료 티어에서 제공됩니다. hs_validate_code 도구는 Pro 티어에서 사용할 수 있으며, 공급업체가 제공한 코드가 불일치하거나 오래된 정보인지 확인합니다. 서버를 설정하려면 ANTHROPIC_API_KEY, HSPING_API_KEY 및 고급 기능을 위한 kordagencies.com의 Pro 키가 필요합니다.
활용 사례
- 1통관 신고 코드 생성제품에 대한 텍스트 설명을 선적 서류용 공식 HS 코드로 변환합니다.
- 2공급업체 정확성 확인공급업체가 제공한 코드가 정확한지, 현재 정부 관세 데이터와 일치하는지 확인합니다.
- 3오분류 위험 완화AI 분석을 사용하여 무역 문서의 잠재적인 오류 또는 오래된 코드를 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
HS Code Classifier MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 HS Code Classifier MCP 설치
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'HSPING_API_KEY=<YOUR_HSPING_API_KEY>' hs-code-classifier-mcp-server -- npx -y hs-code-classifier-mcpCursor에 HS Code Classifier MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"hs-code-classifier-mcp-server": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"HSPING_API_KEY": "<YOUR_HSPING_API_KEY>"
}
}
}
}VS Code에 HS Code Classifier MCP 설치
.vscode/mcp.json
{
"servers": {
"hs-code-classifier-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"HSPING_API_KEY": "<YOUR_HSPING_API_KEY>"
}
}
}
}VS Code CLI에 HS Code Classifier MCP 설치
$ code --add-mcp '{"name":"hs-code-classifier-mcp-server","type":"stdio","command":"npx","args":["-y","hs-code-classifier-mcp"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>","HSPING_API_KEY":"<YOUR_HSPING_API_KEY>"}}'Claude Desktop에 HS Code Classifier MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"hs-code-classifier-mcp-server": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"HSPING_API_KEY": "<YOUR_HSPING_API_KEY>"
}
}
}
}Codex에 HS Code Classifier MCP 설치
$ codex mcp add hs-code-classifier-mcp-server --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'HSPING_API_KEY=<YOUR_HSPING_API_KEY>' -- npx -y hs-code-classifier-mcpCodex config.toml에 HS Code Classifier MCP 설치
~/.codex/config.toml
[mcp_servers.hs-code-classifier-mcp-server] command = "npx" args = ["-y", "hs-code-classifier-mcp"] [mcp_servers.hs-code-classifier-mcp-server.env] ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>" HSPING_API_KEY = "<YOUR_HSPING_API_KEY>"
Gemini CLI에 HS Code Classifier MCP 설치
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -e 'HSPING_API_KEY=<YOUR_HSPING_API_KEY>' hs-code-classifier-mcp-server npx -- -y hs-code-classifier-mcpGemini settings.json에 HS Code Classifier MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"hs-code-classifier-mcp-server": {
"command": "npx",
"args": [
"-y",
"hs-code-classifier-mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
"HSPING_API_KEY": "<YOUR_HSPING_API_KEY>"
}
}
}
}구성
ANTHROPIC_API_KEY필수비밀Anthropic API key for AI-assisted classification reasoning
HSPING_API_KEY필수비밀HSPing API key for official tariff schedule access
API_KEY
| 이름 | 설명 | 유형 |
|---|---|---|
| ANTHROPIC_API_KEY | Anthropic API key for AI-assisted classification reasoning | 필수비밀 |
| HSPING_API_KEY | HSPing API key for official tariff schedule access | 필수비밀 |
| API_KEY | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능ojaskord/hs-code-classifier-mcp-server is public and reachablegithub.com/ojaskord/hs-code-classifier-mcp-server ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-07github.com/ojaskord/hs-code-classifier-mcp-server ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from hs-code-classifier-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음161 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답Endpoint did not answer initialize: HTTP 404결함 발견
README
GitHub에서 보기HS Code Classifier MCP Server
Classify product descriptions to official HS codes and validate supplier-provided codes before customs submissions. Uses official government tariff schedules (USITC, Singapore Customs, CBSA, Australia Border Force) via HSPing API with AI-assisted classification reasoning.
Tools
hs_classify_product (free tier: 10 calls/month)
Convert a product description to the correct HS code before filling any customs declaration, shipping manifest, or duty calculation.
hs_validate_code (Pro tier)
Validate a supplier-provided HS code before approving any shipment or purchase order. Detects mismatches, outdated codes, and misclassification risks using official tariff data and AI analysis.
Usage
HTTP (hosted -- no install required)
https://hs-code-classifier-mcp-production.up.railway.app
npm (Claude Desktop / stdio)
npx hs-code-classifier-mcp
Configure in claude_desktop_config.json:
{
"mcpServers": {
"hs-code-classifier": {
"command": "npx",
"args": ["hs-code-classifier-mcp"],
"env": {
"ANTHROPIC_API_KEY": "sk-ant-...",
"HSPING_API_KEY": "your-hsping-key",
"API_KEY": "your-pro-key-from-kordagencies.com"
}
}
}
}
Harness Integration
Note: this server exposes tools at /mcp not the root URL.
Claude Code / Claude Desktop (.mcp.json)
{
"mcpServers": {
"hs-code-classifier": {
"type": "http",
"url": "https://hs-code-classifier-mcp-server-production.up.railway.app/mcp"
}
}
}
LangChain (Python)
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({
"hs-code-classifier": {
"url": "https://hs-code-classifier-mcp-server-production.up.railway.app/mcp",
"transport": "http"
}
})
tools = await client.get_tools()
OpenAI Agents SDK (Python)
from agents import Agent, HostedMCPTool
agent = Agent(
name="Assistant",
tools=[HostedMCPTool(tool_config={
"type": "mcp",
"server_label": "hs-code-classifier",
"server_url": "https://hs-code-classifier-mcp-server-production.up.railway.app/mcp",
"require_approval": "never"
})]
)
LangGraph
Same as LangChain above — langchain-mcp-adapters works with LangGraph natively.
Pricing
| Tier | Calls | Price |
|---|---|---|
| Free | 10/month | $0 |
| Starter | 500-call bundle | $40 |
| Pro | 2,000-call bundle | $130 |
Get a Pro key: kordagencies.com
Supported Countries
US (USITC), SG (Singapore Customs), CA (CBSA), AU (Australia Border Force), and others via HSPing API.
Legal
Results sourced from official government tariff schedules via HSPing API. For informational purposes only -- not legal or customs advice. Full terms: kordagencies.com/terms.html
HS Code Classifier MCP 질문
HS Code Classifier MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'HSPING_API_KEY=<YOUR_HSPING_API_KEY>' hs-code-classifier-mcp-server -- npx -y hs-code-classifier-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
HS Code Classifier MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
무료 티어 제한은 무엇인가요?
무료 티어에서는 한 달에 10회 호출이 가능합니다.
어느 국가를 지원하나요?
HSPing API를 통해 미국(USITC), 싱가포르(Singapore Customs), 캐나다(CBSA), 호주(Australia Border Force) 및 other 국가를 지원합니다.
공급업체 코드를 검증할 수 있나요?
네, Pro 티어에는 공급업체가 제공한 HS 코드를 검증하여 불일치 및 오분류 위험을 감지하는 도구가 포함되어 있습니다.