tarigrisurgical-mcp-server

Tarigri Surgical MCP サーバー

tarigrisurgical.com 向けの Model Context Protocol サーバーです。同サイトは、パキスタンのシアルコートにある、ステンレス製の外科、歯科、整形外科、耳鼻咽喉科用器具のメーカーです。AI アシスタントが卸売カタログを検索し、数量に応じた価格を計算して、注文依頼を作成できます。

qmmughal/mcp-server-template を基に構築し、高水準の McpServer API（SDK 1.32）にアップグレードしています。

標準規格への対応状況

領域	状況
トランスポート	stdio（ローカル、npx/node）および Streamable HTTP（リモート、ステートレス、POST /mcp、Vercel にデプロイ可能）
プロトコル	公式 TypeScript SDK によってネゴシエートされます（2025-06-18 以前を含む）
ツール	6 つのツール。それぞれに title、JSON-Schema 入力、outputSchema + structuredContent、アノテーション（readOnlyHint、destructiveHint: false、idempotentHint、openWorldHint）があります
エラー	ツールの失敗は isError: true の結果を返します（プロトコルエラーではありません）。不正な引数はスキーマ検証で拒否されます
リソース	静的な tarigri://catalog、引数補完に対応した一覧表示可能なテンプレート tarigri://product/{sku}
プロンプト	型指定された引数を持つ source_instruments
サーバー情報	name、title、version、websiteUrl、およびモデル向けの instructions
安全性	読み取り専用です。注文や送信は行われません。stdout は JSON-RPC 専用で、ログは stderr に出力されます
テスト	24 件のテスト。実際の MCP Client を介したプロトコルレベルのテストを含みます。stdio と HTTP の両方で公式 MCP Inspector による検証済みです
未実装	認証（公開カタログデータのため）、セッション／SSE ストリーム（設計上ステートレス）、サンプリング／エリシテーション（不要）

ツール

ツール	目的
search_products	テキスト、カテゴリ、上限価格、売れ筋で絞り込みます
get_product	SKU の詳細情報（価格、MOQ、50+/100+ の価格帯、素材、サイズ、URL）を取得します
list_categories	商品数付きの 8 つのカテゴリを一覧表示します
estimate_quote	SKU と数量の明細ごとの概算合計を算出します。数量別価格を適用し、MOQ 未満の数量を通知します
get_company_info	連絡先、営業時間、購入者向け FAQ を取得します
draft_inquiry	ユーザー自身が送信するための、テキスト形式の見積依頼と mailto: および WhatsApp のリンクを作成します

すべての価格は工場直販の卸売価格（米ドル、FOB シアルコート）です。送料は Tarigri が別途見積もります。

仕組み

サイトは API のないクライアントレンダリングの SPA ですが、カタログを /data.js として公開しています。サーバーはこれを取得して Zod で検証し、サイト独自のレートを使って PKR 価格を USD に換算したうえで、メモリにキャッシュします（デフォルトは 15 分。更新に失敗した場合は古いコピーを提供します）。

ローカルで実行する

npm install
npm run build        # dist/index.js (single bundled executable with shebang)
npm test
npm run inspect      # opens the official MCP Inspector against the build

変数	デフォルト	意味
TARIGRI_SITE_ORIGIN	https://tarigrisurgical.com	/data.js を配信するサイト
CATALOG_CACHE_TTL_SECONDS	900	カタログのキャッシュ期間
LOG_LEVEL	info	ログは stderr のみに出力されます
LOG_PRETTY	false	tsx でソースから実行する場合の整形ログ（バンドルではありません）

Vercel にデプロイする（リモートサーバー）

このリポジトリは Vercel 対応済みです。api/mcp.ts が関数で、/mcp から関数へリライトされます。また、public/index.html は設定をコピーして貼り付けられるランディングページです。

1. Vercel ダッシュボードで Add New → Project を選択し、qmmughal/tarigrisurgical-mcp-server をインポートします（または npx vercel login && npx vercel --prod を実行します）。
2. デフォルト設定をそのまま使用します（vercel.json でフレームワークと出力ディレクトリが設定されています）。環境変数は不要です。
3. 任意：Project → Domains で mcp.tarigrisurgical.com などのドメインを追加します。

エンドポイントは https://<your-domain>/mcp になります。公開カタログのみを公開する設計のため、エンドポイントは認証なしで公開されています。大量のトラフィックが見込まれる場合は、Vercel の WAF／レート制限を追加してください。

AI ツールから接続する

<URL> を Vercel のエンドポイント（https://…/mcp）に置き換えてください。パッケージが npm に公開されるまでは、npx の代わりに、dist/index.js の絶対パスを指定したローカルの node 形式を使用してください。

Claude Code

claude mcp add --transport http tarigri-surgical <URL>
# or local: claude mcp add tarigri-surgical -- node /abs/path/dist/index.js

Claude Desktop：設定 → コネクタ → カスタムコネクタを追加 から <URL> を指定するか、claude_desktop_config.json を使用してください：

{ "mcpServers": { "tarigri-surgical": { "command": "node", "args": ["/abs/path/dist/index.js"] } } }

Cursor（.cursor/mcp.json）

{ "mcpServers": { "tarigri-surgical": { "url": "<URL>" } } }

VS Code / GitHub Copilot（.vscode/mcp.json）

{ "servers": { "tarigri-surgical": { "type": "http", "url": "<URL>" } } }

Windsurf（~/.codeium/windsurf/mcp_config.json）

{ "mcpServers": { "tarigri-surgical": { "serverUrl": "<URL>" } } }

Gemini CLI（~/.gemini/settings.json）

{ "mcpServers": { "tarigri-surgical": { "httpUrl": "<URL>" } } }

Codex CLI（~/.codex/config.toml）

[mcp_servers.tarigri-surgical]
command = "node"
args = ["/abs/path/dist/index.js"]

stdio のみをサポートするクライアント：npx -y mcp-remote <URL>。

注意事項

• data.js はタイムアウト付きの空の node:vm コンテキストで評価され、その後スキーマ検証が行われます。vm はセキュリティサンドボックスではないため、TARIGRI_SITE_ORIGIN には信頼できるサイトのみを指定してください。
• サイトの商品画像はイメージです。CE／ISO 証明書番号は公開されておらず、「ご要望に応じて提供」とされています。サーバーがそれ以上のことを主張することはありません。
• サイトで data.js の形式が変更された場合、検証は明確なエラーを返し、不正なデータを返すことはありません。

ライセンス

MIT