ALT/FNDATA

ALT/FNDATA MCP Server

AI アシスタントを、ラグジュアリー品やコレクターズアイテムのオークションデータに接続できます。100 以上の世界各地のオークションハウスから、時計、ジュエリー、ルース宝石、ハンドバッグ、自動車、オートバイ、航空機、ワインとウイスキー、美術品、芸術作品、デザイン、ファッション、靴、オートモビリア、書籍、コイン、香水、アクセサリー、楽器、その他の乗り物について、自然な言葉で検索できます。

オープンな Model Context Protocol（MCP）を使用しているため、Claude、ChatGPT、Gemini、Perplexity、その他の MCP サーバーに対応したアシスタントや開発者向けツールで利用できます。

クイックスタート

1. API キーを取得する

ALT/FNDATA アプリの API Key & MCP からキーを取得します。

2a. ホスト型サーバーに接続する（インストール不要）

リモート MCP サーバー（カスタムコネクターと呼ばれることもあります）に対応したアシスタントで、次の URL を使ってコネクターを追加します。

https://mcp.altfndata.com/mcp

認証方法を尋ねられたら、OAuth を選択します。その後、サインインページで ALT/FNDATA API キーを入力します。

• Claude： Settings → Connectors → add a custom connector.
• ChatGPT： カスタムコネクターとして追加します（開発者モード）。ChatGPT はホスト型サーバーにのみ接続するため、この方法を使用してください。
• Perplexity： Settings → Connectors → add a custom connector with the URL above.
• Gemini app： Settings → Connected Apps → add a custom app with the URL above（個人の Google アカウント）。
• Gemini Enterprise： 管理者が組織用に ALT/FNDATA を一度追加します。下記の Gemini Enterprise の設定（管理者向け） を参照してください。

メニュー名やプランの利用条件は各アシスタントが定めており、時間の経過とともに変更されるため、手順が異なる場合はヘルプページを確認してください。

Gemini Enterprise（管理者向けの設定）

Gemini Enterprise は、管理者が組織用に一度設定する Custom MCP Server データストアを通じて接続します。

1. クライアントを登録します。レスポンスには client_id と client_secret が含まれます。シークレットは一度しか表示されないため、安全に保管してください。

   curl -X POST https://mcp.altfndata.com/register \
     -H "Content-Type: application/json" \
     -d '{"client_name": "Gemini Enterprise (your organisation)",
          "redirect_uris": ["https://vertexaisearch.cloud.google.com/oauth-redirect"],
          "token_endpoint_auth_method": "client_secret_post",
          "grant_types": ["authorization_code", "refresh_token"],
          "response_types": ["code"],
          "scope": "read"}'
   

2. Gemini Enterprise コンソールで、次の値を使って Custom MCP Server データストアを追加します。

   フィールド	値
   MCP Server URL	https://mcp.altfndata.com/mcp
   Authorization URL	https://mcp.altfndata.com/authorize
   Token URL	https://mcp.altfndata.com/token
   Client ID	手順 1 の client_id
   Client Secret	手順 1 の client_secret
   Scopes	read
   Enable PKCE	チェック済み

3. その後、各ユーザーが Gemini から接続し、それぞれの ALT/FNDATA API キーでサインインします。クライアント ID とシークレットは、組織の Gemini Enterprise を識別するためだけのもので、それだけではデータにアクセスできません。

カスタム MCP サーバーの設定に関する Google のガイドでは、コンソール画面について説明しています。

2b. またはローカルで実行する

デスクトップアプリや、コンピューター上で MCP サーバーを起動する開発者向けツールでは、pip でインストールするか、

pip install altfinance-mcp

uv を使ってインストールせずに実行します。クライアントの command に uvx を指定し、引数として altfinance-mcp を渡します（下記の uvx 設定例を参照してください）。

uvx altfinance-mcp

ほとんどのツールでは、この形式の設定を使用します。ツールの MCP 設定に追加して、ツールを再起動してください。

例、Claude Desktop： 設定ファイルは、Windows では %APPDATA%\Claude\claude_desktop_config.json、macOS では ~/Library/Application Support/Claude/claude_desktop_config.json です。

{
  "mcpServers": {
    "altfinance": {
      "command": "altfinance-mcp",
      "env": {
        "ALTFINANCE_API_KEY": "your-api-key-here"
      }
    }
  }
}

uvx（pip install は不要）を使う場合は、"command": "uvx" を指定し、パッケージを引数として渡します。

{
  "mcpServers": {
    "altfinance": {
      "command": "uvx",
      "args": ["altfinance-mcp"],
      "env": {
        "ALTFINANCE_API_KEY": "your-api-key-here"
      }
    }
  }
}

例、Claude Code：

claude mcp add altfinance -- altfinance-mcp

起動前に環境変数を設定します：

export ALTFINANCE_API_KEY="your-api-key-here"

質問できること

接続すると、アシスタントに次のような質問ができます。

• 「ALT/FNDATA データベースで利用できるテーブルは何ですか？」
• 「watches テーブルのスキーマを表示してください」
• 「2020年以降に販売された、最も高額なロレックスの時計を上位10件探してください」
• 「Christie's ではエルメスのハンドバッグがいくつ販売されましたか？」
• 「Phillips で販売されたパテック フィリップの時計の市場統計を教えてください」
• 「過去5年間でエルメス バーキンの価格はどのように推移しましたか？」
• 「ロレックス デイトナ 116500 白文字盤の価格を確認してください」
• 「市場全体から、5万ドルを超えるビルマ産ルビーの指輪を検索してください」
• 「オークションで販売されたルースサファイアには何がありますか？」（jewelry ではなく gems を使用します）

利用可能なツール

9つのツールはすべて読み取り専用で、readOnlyHint: true が付与されています。どのツールもデータを変更しません。

ツール	説明
list_tables	説明と列数がリアルタイムで表示された、利用可能な20個のテーブルを一覧表示します
get_table_schema	1つのテーブルの列名と型を表示します
query_table	フィルター、並べ替え、フィールド選択、ページネーションを指定してテーブルを検索します
market_stats	テーブルまたはフィルター対象のセグメントについて、販売件数、中央値、25・75パーセンタイル、平均、最小値・最大値、販売日の範囲、販売量上位の業者をまとめた実現価格の概要を表示します
price_trend	実現価格の推移を、年・四半期・月単位にまとめて表示します（期間ごとの件数、中央値、平均）
price_check	類似販売品に基づく単品の適正価格帯と、出典へのリンクを表示します。リアルタイムの比較対象カテゴリは、ハンドバッグ、時計、自動車です
search	すべてのカテゴリを一度に対象とした市場全体のキーワード検索を行い、実現価格順にまとめます。カテゴリを指定しない場合は、20個すべてのテーブルを対象に検索します
market_index	ブランドまたはモデルごとの、事前計算済み価格指数（下限・25パーセンタイル・中央値・75パーセンタイル・上限、サンプル数、トレンド）を表示します。対象カテゴリは、ハンドバッグ、時計、自動車です
list_alerts	価格アラートの読み取り専用ビューを表示するか、有効化する方法を案内します。以下の「価格アラートは読み取り専用です」を参照してください

すべてのツールに readOnlyHint と openWorldHint が付与されています。

価格アラートは読み取り専用です

価格アラートはAPIキーではなく、ログイン済みのALT/FNDATAアカウント（Cognitoログイン）に紐付けられています。MCPはAPIキーのみで認証するため、アラートを作成または有効化できず、APIキーで呼び出す場合はアラートフィード自体にもアクセスできません。そのため、list_alerts は（セッションによってフィードにアクセスできる場合）発火済みのアラートを表示するか、app.altfndata.com のアプリでアラートを設定する方法を案内します。プランごとのアラート利用枠は、無料プランが0件、登録済みプランが1件、コレクタープランが10件、プロプランが100件で、Membershipには含まれています。

機能とプランの案内

ツールの応答には、ALT/FNDATAの関連製品またはプランのアップグレードを提案する、短い「💡」の行が追加されることがあります。これは、実際にプランの境界に該当する場合（利用中のプランに含まれないテーブル、または上限に達した行数）か、関連する機能のヒントがある場合に限り、応答ごとに最大1回表示されます。利用無制限のアカウントやコンプアカウントでは表示されません。返されるデータが変わることはありません。

クエリ機能

• 任意の列を次の演算子でフィルターできます：eq、neq、gt、gte、lt、lte、like、in、not_in、is_null、is_not_null
• 任意の列を昇順または降順で並べ替えできます
• 返すフィールドを指定して選択できます
• limit/offsetを指定してページネーションできます（1リクエストあたり最大500行）

データの収録範囲

データベースには20のテーブルがあります。最新のテーブル一覧と現在のカラム数は、list_tables を呼び出して確認してください。

テーブル	説明
watches	高級腕時計のオークション落札結果
handbags	高級ハンドバッグのオークション落札結果
jewelry	宝石をあしらった完成品のジュエリー（リング、ネックレス、ブレスレット、イヤリングなど）
gems	ルースの未セッティング宝石（単石およびパーセル）。宝石の評価には jewelry ではなく、こちらを使用してください
automobile	コレクターカーのオークション落札結果
motorcycle	コレクター向けオートバイのオークション落札結果
aircraft	航空機のオークション落札結果
wine_whisky	ワインおよびウイスキーのオークション落札結果
works_of_art	石やジュエリーに関連する美術品（翡翠、ジェダイト、ダイヤモンドをあしらった作品など）
fine_art	あらゆる美術様式および時代の美術品のオークション落札結果
design	デザインおよび装飾美術品：家具、照明、ガラス、陶磁器、スタジオデザイン・工業デザイン
fashion	ファッションおよびクチュール：衣類とアクセサリー（ハンドバッグと靴は、それぞれ専用のテーブルがあるため含みません）
shoes	靴類：デザイナーシューズおよびコレクター向けスニーカー
automobilia	自動車関連の記念品、部品、看板、模型などのコレクターズアイテム（自動車そのものは含みません）
books	書籍、写本、地図、印刷物
coins	貨幣のオークション落札結果
other_automobile	その他の乗り物：ボート、トラクター、トラック、バス、軍用車両（自動車とオートバイは含みません）
perfume	香水およびコレクター向けの香水瓶・フラコン
accessories	ファッションアクセサリー：ベルト、スカーフ、カフリンクス、ブローチ、サングラスなど。宝石をあしらった品も含みます
musical_instruments	楽器：ギター、バイオリン属、ピアノ、キーボード、木管楽器、金管楽器、打楽器、アンプ

gems と jewelry の違い： gems にはルースの未セッティング宝石（宝石の評価に適したテーブル）が格納されています。jewelry には石をセッティングした完成品が格納されています。一方のテーブルで結果が見つからない場合は、もう一方を試してください。

データソースには、Christie's、Sotheby's、Phillips、Bonhams、Artcurial、Dorotheum、Heritage Auctionsのほか、世界各地の100以上のオークションハウスが含まれます。

ホスト型サーバー

https://mcp.altfndata.com/mcp にあるホスト型サーバー（クイックスタートの2a）は、このパッケージをHTTPモードで実行したものです。OAuthに対応するリモートサーバーをサポートするMCPクライアントであれば接続できます。サインインページでALT/FNDATA APIキーを入力するため、ローカルへのインストールは不要です。

リモートサーバーのセルフホスト

MCPサーバーをリモート（HTTP）モードで実行するには：

export ALTFINANCE_TRANSPORT=streamable-http
export ALTFINANCE_ISSUER_URL=https://mcp.altfndata.com
export ALTFINANCE_RESOURCE_URL=https://mcp.altfndata.com
python -m altfinance_mcp

または、Dockerを使用します：

docker build -t altfinance-mcp .
docker run -p 8000:8000 \
  -e ALTFINANCE_TRANSPORT=streamable-http \
  -e ALTFINANCE_ISSUER_URL=https://mcp.altfndata.com \
  -e ALTFINANCE_RESOURCE_URL=https://mcp.altfndata.com \
  altfinance-mcp

リモートサーバーは次のエンドポイントを公開します：

• POST/GET/DELETE /mcp — MCP Streamable HTTPエンドポイント（認証必須）
• GET /.well-known/oauth-authorization-server — OAuthメタデータ
• POST /register — 動的クライアント登録
• GET /authorize — OAuth認証
• POST /token — トークン交換
• GET/POST /login — APIキー入力フォーム

環境変数

ローカル（stdio）モード

変数	必須	デフォルト	説明
ALTFINANCE_API_KEY	はい	—	ALT/FNDATA APIキー
ALTFINANCE_API_URL	いいえ	https://api.altfndata.com	APIベースURL

リモート（HTTP）モード

変数	必須	デフォルト	説明
ALTFINANCE_TRANSPORT	はい	stdio	streamable-http に設定します
ALTFINANCE_API_URL	いいえ	https://api.altfndata.com	APIベースURL
ALTFINANCE_HOST	いいえ	0.0.0.0	HTTPリッスンアドレス
ALTFINANCE_PORT	いいえ	8000	HTTPリッスンポート
ALTFINANCE_ISSUER_URL	いいえ	http://localhost:8000	OAuth発行者URL（公開URL）
ALTFINANCE_RESOURCE_URL	いいえ	発行者と同じ	OAuthリソースサーバーURL

プライバシーポリシー

この MCP サーバーは、ALT/FNDATA API（api.altfndata.com）に接続して、オークションデータを取得します。データの取り扱いについて、以下に説明します。

• データ収集：サーバーは、API キーとクエリパラメーター（テーブル名、フィルター、並べ替えオプション）を ALT/FNDATA API に送信します。API の認証とクエリの実行に必要なものを除き、個人ユーザーデータは収集しません。
• 利用と保存：クエリデータはリアルタイムで処理され、MCP クライアントに返されます。サーバーはクエリ結果やユーザーデータをローカルに永続化、キャッシュ、保存しません。
• 第三者との共有：データは MCP クライアントと ALT/FNDATA API（api.altfndata.com）の間でのみやり取りされます。ほかの第三者とデータを共有することはありません。
• データ保持：サーバーはステートレスです。セッションの終了後、ユーザーデータやクエリ履歴は保持されません。
• お問い合わせ：プライバシーに関するお問い合わせは、[email protected] までご連絡ください。

プライバシーポリシー全文：https://altfndata.com/privacy-policy/

サポート

• ドキュメント：https://docs.altfndata.com
• メール：[email protected]

必要条件

• Python 3.10+
• ALT/FNDATA API キー

ライセンス

MIT