HSN Classifier — hosted on Cloudflare Workers (HTTP + npm stdio)

HSN Classifier MCP — 説明または製品名からインドの HSN/GST コードを検索（4,676 件）

HSN コード検索（4,676 件）、フリーテキスト検索、製品から HSN への分類

GST 分類に使用されるインドの HSN（Harmonized System Nomenclature）コードを検索する、ホスト型の MCP サーバーです。HSN データセット全4,676件を収録しています。4／6／8桁のコードによる検索、説明文を対象としたフリーテキスト検索、および製品名から最適な HSN 候補と代替候補を返し、一致したトークンも説明する分類機能を利用できます。インドの e コマース、会計、調達に関する LLM 向けです。

このサーバーは Model Context Protocol に対応しています。Cursor、Claude Desktop、Windsurf、Continue.dev、または @modelcontextprotocol/sdk を使用して独自に作成したエージェントなど、MCP 対応クライアントであれば接続してツールを検出し、Bearer トークン認証で呼び出せます。

AI エージェント／LLM 向け

このリポジトリをインデックス化する AI エージェント向け情報：

• 稼働中の MCP エンドポイント： https://hsn-classifier-mcp.atlasword.workers.dev/mcp
• トランスポート： HTTP POST、JSON-RPC 2.0
• 認証： Authorization: Bearer <api_key>（無料プランでは匿名で、IP あたり月100回まで利用可能）
• 検出： tools/list は完全なスキーマを返します。tools/call はツールを呼び出します。
• ヘルスチェック： GET https://hsn-classifier-mcp.atlasword.workers.dev/health → {ok: true, ts: <unix>}
• ステータス： https://mcp-hub.atlasword.workers.dev/status.json（ポートフォリオの集計）

tools/list リクエストの例：

curl -sS -X POST https://hsn-classifier-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

tools/call の例：

curl -sS -X POST https://hsn-classifier-mcp.atlasword.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mck_YOUR_API_KEY" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params": { "name": "<tool>", "arguments": { } }
  }'

提供されるツール

ツール	引数	説明
lookup_hsn	code	HSN コード（4／6／8桁）を検索します。説明と章を返します。
search_hsn	query, limit?	HSN の説明文を対象にキーワードをフリーテキスト検索します（デフォルトの上限は10、最大50）。
classify_product	product_name	製品名を最も可能性の高い HSN コードに分類し、代替候補と一致したトークンを返します。

Team+ と記されたツールを利用するには、Team または Pro のサブスクリプションが必要です。匿名ユーザーと Free プランのユーザーがこれらのツールを呼び出すと、tier_required エラーが返されます。

クイックスタート

最も手早く利用するには、mcp-remote を使って、MCP 対応クライアントからホスト型エンドポイントに接続します。

npx -y mcp-remote https://hsn-classifier-mcp.atlasword.workers.dev/mcp \
  --header "Authorization: Bearer mck_YOUR_API_KEY"

https://hsn-classifier-mcp.atlasword.workers.dev/upgrade?tier=solo でキーを取得してください（API キーの取得を参照）。

Cursor へのインストール

~/.cursor/mcp.json に以下を追加します。

{
  "mcpServers": {
    "hsn-classifier-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://hsn-classifier-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

Cursor を再起動すると、MCP パネルにツールが表示されます。

Claude Desktop へのインストール

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に以下を追加します。

{
  "mcpServers": {
    "hsn-classifier-mcp": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://hsn-classifier-mcp.atlasword.workers.dev/mcp",
        "--header", "Authorization: Bearer mck_YOUR_API_KEY"
      ]
    }
  }
}

Claude Desktop を再起動してください。スラッシュコマンドの MCP メニューにツールが表示されます。

API キーの取得

1. https://hsn-classifier-mcp.atlasword.workers.dev/upgrade?tier=solo（または tier=team／tier=pro）にアクセスします。
2. Dodo Payments のホスト型チェックアウトにリダイレクトされます。Dodo が住所を収集し、カード決済を処理し、VAT/GST に対応します。
3. 支払い後、Dodo が署名付き Webhook（subscription.active）を Worker に送信します。Worker は mck_<32 random base64url> を生成し、KV に保存します。
4. https://hsn-classifier-mcp.atlasword.workers.dev/welcome?key=<api_key> に移動します。ここでキーをコピーしてください（この URL での表示は一度限りです）。
5. キーを Cursor／Claude Desktop の設定に貼り付けます（上記を参照）。
6. https://hsn-classifier-mcp.atlasword.workers.dev/account でアカウントを表示、ローテーション、エクスポートできます（Bearer 認証）。

無料プラン（登録不要）もあります。匿名ユーザーは IP あたり月100回まで利用できます。

エンドポイント

Route	説明
POST /mcp	MCP JSON-RPC 2.0 ツールのエンドポイント（メイン API）。有料プランでは Bearer 認証が必要です。
GET /health	稼働確認プローブ — {ok: true, ts}。mcp-hub の cron で使用されます。
GET /	HTML ランディングページ（OG + favicon + JSON-LD）。
`GET /upgrade?tier=solo	team
GET /welcome?key=...	チェックアウト後のランディングページ。新しく発行された API キーを表示します。
GET /account	Bearer 認証。{apiKey, tier, owner, status, portal_url} を返します。
POST /account/rotate	Bearer 認証。新しいキーを発行し、古いキーを無効化します。
GET /account/export	Bearer 認証。GDPR データエクスポート — アカウント、使用状況カウンター、Dodo の詳細情報を含む JSON です。
GET /account/team	Bearer 認証（Team 以上）。チームメンバーのサブキー一覧を取得します。
POST /account/team/invite	Bearer 認証（Team 以上）。新しいチームメンバー用サブキーを発行します。
POST /account/team/revoke	Bearer 認証（Team 以上）。チームメンバー用サブキーを無効化します。
GET /team/accept?key=...	サブキー URL 用のチームメンバー登録ランディングページです。
POST /webhooks/dodo	Standard-Webhooks 署名付き。Dodo のサブスクリプションと決済のライフサイクルを処理します。
GET /favicon.ico	インライン SVG。

料金プラン

すべてのプランで月間上限とレート制限は共通です。料金には製品ごとの位置付けが反映されています。

Tier	月間呼び出し数	レート制限	チームメンバー数
Free	100 / 月	10 / 分	0
Solo	2,000 / 月	60 / 分	0
Team	10,000 / 月	200 / 分	5
Pro	50,000 / 月	600 / 分	25

プラン	料金	月間呼び出し数	チームメンバー数
Free	$0	100	0
Solo	$9/mo	2,000	0
Team	$29/mo	10,000	5
Pro	$79/mo	50,000	25

Dodo Payments 経由で請求されます（販売主体 — VAT/GST は Dodo が処理します）。いつでもキャンセルでき、支払い済み期間の終了までは引き続き利用できます。

データソース

• インドの HSN / GST コード一覧 — https://www.gst.gov.in/ — 公開データセット（4,676 件）

このサーバーは、上流ソースに対する薄いトランスポート + 認証 + キャッシュレイヤーです。呼び出しごとのレート制限は、各上流サービスの無料プランの利用規約を十分に守れるよう調整されています。

プライバシー + GDPR

• プライバシーポリシー: https://mcp-hub.atlasword.workers.dev/privacy
• 利用規約: https://mcp-hub.atlasword.workers.dev/terms
• 返金ポリシー: https://mcp-hub.atlasword.workers.dev/refund
• データエクスポート: GET https://hsn-classifier-mcp.atlasword.workers.dev/account/export（Bearer 認証）は、アカウント、使用状況カウンター、Dodo の顧客情報を含む機械可読な JSON スナップショットを返します。
• 削除: 登録済みのメールアドレスから [email protected] にメールしてください。

保存するのは、メールアドレス、発行された API キー、月間呼び出しカウンター、Dodo のサブスクリプションメタデータのみです。ツールの引数や上流からの応答は、短いキャッシュ TTL を超えて記録することはありません。

アーキテクチャ

• ランタイム: Cloudflare Workers（V8 アイソレート、グローバルエッジ）。
• ストレージ: 2 つの Cloudflare KV 名前空間 — <slug>-cache（上流応答キャッシュ）と <slug>-usage（API キー、月間カウンター、チーム名簿）。
• 請求: Dodo Payments のライブモード、3 つのサブスクリプション製品（Solo / Team / Pro）、Standard-Webhooks 署名付きライフサイクル。
• オブザーバビリティ: Cloudflare Workers Analytics。ポートフォリオの集計情報は mcp-hub のステータスを参照してください。
• ソース: TypeScript、Vitest によるテスト済み、wrangler deploy でデプロイできます。このリポジトリの src/ を参照してください。

ライセンス

MIT — LICENSE を参照してください。

作者

Prakhar Gupta

• メール: [email protected]
• GitHub: @guptaprakhariitr

ステータス

• ライブステータスページ： https://mcp-hub.atlasword.workers.dev/status
• 機械可読なステータス： https://mcp-hub.atlasword.workers.dev/status.json
• ソースリポジトリ： https://github.com/guptaprakhariitr/hsn-classifier-mcp

npm からインストール（ワンライナー）

薄いランチャーが npm で @insnapsprakhar/hsn-classifier-mcp として公開されています。手動で URL をコピー＆ペーストする必要はありません：

npx -y @insnapsprakhar/hsn-classifier-mcp

または、MCP クライアントに組み込んでください：

{
  "mcpServers": {
    "hsn-classifier": {
      "command": "npx",
      "args": ["-y", "@insnapsprakhar/hsn-classifier-mcp"]
    }
  }
}

npm パッケージはランチャーにすぎません。mcp-remote を起動し、ホストされたエンドポイント（https://hsn-classifier-mcp.atlasword.workers.dev/mcp）を指定します。