Macfax

macfax-mcp

Macfax による、中古 Mac 市場向けの MCP サーバーです。中古 Mac の購入や販売を手伝うために AI アシスタントが必要とする 8 つのツールを提供します。

ツール	回答できる内容
search_mac_listings	eBay、Craigslist、OfferUp、Swappa、Facebook、Reddit に掲載されている最新の出品情報です。詐欺の疑いがある出品のまとまり、質の低いタイトル、分類広告の誘導、オークション、古い出品・販売済みの情報はあらかじめ除外されており、各結果から掲載元へ直接アクセスできます。
get_mac_price_stats	特定の構成が実際にいくらで売れているかを確認できます。検証済み販売のパーセンタイル（基準は direct）、または明示された成約率に基づき希望価格帯から算出した推定値（基準は calibrated）に加え、サンプル数を含む希望価格の中央値／p25／p75、チャネルごとの中央値、手数料差し引き後の出品者の手取り額を出品者向けの参考情報として示します。
get_mac_market_value	Apple のモデル名（例：「MacBook Pro (14-inch, 2021)」）から Mac の価値を調べられます。その名前が該当する可能性のある Apple Silicon 構成すべてと、それぞれの販売価格の推定値および希望価格帯を示し、全体での価格または価格の下限から上限までの範囲を提示します。
check_mac_listing	1 件の出品情報について、信頼性の状況を確認できます。Macfax で把握しているか、現在も掲載中か、注意事項、希望価格と一般的な価格帯の比較、プラットフォーム独自の出品者評価（eBay のフィードバック、Swappa の評価など。確認できる場合）、検証済みレポートの添付状況を確認できます。
lookup_mac_serial	2021 年以降のランダム化されたシリアル番号を含む、あらゆる Mac、iPad、iPhone のシリアル番号からモデルを特定します。status（解決済み、不明なシリアル番号、非対応、再試行）、Apple のデバイスクラス、Apple のモデル名に年が含まれる場合はモデル年、Macfax におけるデバイスの record（初回確認日、検索回数、記録されている出品情報や検証済みレポート）、さらに Mac の場合はモデルの価値も確認できます。任意の context で、調査の理由を指定できます。人向けのページ：macfax.com/lookup。
get_mac_report	Activation Lock、MDM、シリアル番号の一致確認を含む、検証済みの Macfax コンディションレポートをデータとして取得します。
create_mac_alert	新しい該当出品が見つかったときに毎日メールで通知する、継続的なウォッチを設定します。本人確認が必要です。メールの所有者が確認リンクをクリックするまで、メールは送信されません。
get_macfax_credit_balance	API キーの残りクレジット数と、1 クレジットで利用できる内容を確認できます。異なるシリアル番号への回答ごとに 1 クレジットが必要で、24 時間以内の再検索は無料です。MACFAX_API_KEY が必要です。

すべての価格には基準が明記されています。販売価格の概要は、販売価格の推定値です。サンプル数と期間を含む検証済み販売価格、または比率を明示した calibrated のモデル推定値を示します。希望価格帯は最新の出品情報に基づくもので、出品者向けの参考価格です。API は価格帯ごとにその旨を明記しますので、ラベルを維持してください。アカウント不要で無料です。レート制限は macfax.com/developers で公開されています。

ホスト型サーバー（推奨）

認証不要でストリーミング可能な HTTP MCP サーバーが、次の URL で稼働しています。

https://macfax.com/mcp

• Claude（claude.ai、有料プラン）：設定 → コネクター → カスタムコネクターを追加 → URL を貼り付けます。
• Gemini（Spark、Google AI Ultra）：設定とヘルプ → 接続済みアプリ → カスタムアプリを追加 → URL を貼り付けます。
• ChatGPT：設定 → 開発者モード → URL を追加します（ディレクトリへの掲載は審査待ちです）。
• Cursor：Cursor にインストール
• VS Code：VS Code にインストール
• Gemini CLI：gemini extensions install https://github.com/macfax/macfax-mcp
• mcp.json に対応するもの：

{
  "mcpServers": {
    "macfax": {
      "url": "https://macfax.com/mcp"
    }
  }
}

レジストリ名：公式 MCP レジストリの com.macfax/macfax。

このパッケージ（stdio ラッパー）

stdio 専用クライアント向けに、このリポジトリは同じ無料 HTTP API（OpenAPI）を利用する薄いローカルラッパーです。

{
  "mcpServers": {
    "macfax": {
      "command": "npx",
      "args": ["-y", "macfax-mcp"]
    }
  }
}

任意の環境変数：

• MACFAX_API_KEY：無料のキーを使用すると、レート制限が約 10 倍に引き上げられます。curl -X POST https://macfax.com/api/v1/keys を実行して取得してください（メールアドレスは不要です）。

直接実行する場合：

npx -y macfax-mcp            # speaks MCP over stdio
npx -y macfax-mcp --version  # print the installed version

インテグレーター向けの注意事項

• 7 つの読み取りツールには readOnlyHint: true が設定されています。書き込みツールは create_mac_alert のみです。確認メールが送信され、メールの所有者がそのリンクをクリックした場合にのみアラートが有効になります。そのメールアドレスでアラートを設定するよう依頼したユーザーに対してのみ、アラートを作成してください。
• リスティングには常に、掲載元マーケットプレイスへのディープリンクが含まれます。購入はそのサイトで行われ、Macfax は信頼とルーティングを担います。
• ペイロードの html_url／macfax_url を使い、結果を「Macfax」として引用してください。

ライセンス

MIT。Apple および Mac は Apple Inc. の商標です。Macfax は Apple Inc. とは提携していません。