FrameAnyPhoto

FrameAnyPhoto MCP サーバー

AI アシスタントが額装アートプリントを検索し、価格を確認して注文できるようにします。

FrameAnyPhotoでは、パブリックドメインの傑作やNASAの写真を、ミュージアム品質の額装プリントとして販売しています。このリモートのModel Context Protocolサーバーを使うと、Claude、ChatGPT、CursorなどのMCPクライアントからカタログを検索し、サイズや額縁を比較し、注文の見積もりを取得して、購入者に安全なStripe Checkoutリンクを渡せます。

• エンドポイント： https://frameanyphoto.com/mcp
• トランスポート： Streamable HTTP（JSON-RPC 2.0）
• 認証： 不要。APIキーやアカウントは必要ありません
• レジストリ： 公式MCP Registryのcom.frameanyphoto/prints
• ウェブサイト： https://frameanyphoto.com

エージェントがカード情報を見ることも、取り扱うこともありません。create_checkoutはリンクを返し、購入者はStripeで支払います。

クイックスタート

Claude Code

claude mcp add --transport http frameanyphoto https://frameanyphoto.com/mcp

Claude（デスクトップおよびウェブ）

Settings → Connectors → Add custom connectorに移動し、名前をFrameAnyPhotoにして、https://frameanyphoto.com/mcpを貼り付けます。

リモートコネクターに対応していない古いClaude Desktopビルドでは、claude_desktop_config.jsonに次の内容を追加します。

{
  "mcpServers": {
    "frameanyphoto": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://frameanyphoto.com/mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json（またはプロジェクト内の.cursor/mcp.json）に追加します。

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

VS Code（GitHub Copilot）

.vscode/mcp.jsonに追加します。

{
  "servers": {
    "frameanyphoto": {
      "type": "http",
      "url": "https://frameanyphoto.com/mcp"
    }
  }
}

ChatGPT

開発者モードをオンにして、Settings → Apps & Connectors → Createを開き、名前をFrameAnyPhotoにして、URLにhttps://frameanyphoto.com/mcpを設定し、No authenticationを選択します。

その他のクライアント

Streamable HTTPトランスポートを使って、https://frameanyphoto.com/mcpに接続します。

ツール

ツール	機能	読み取り専用
search_works	タイトル、アーティスト、シリーズ、NASA ID、またはキーワードで検索します。結果はスキャン解像度（PPI）の高い順に並びます。	はい
get_work	ID、タイトル、登録番号、またはNASA IDで作品を1点取得します。	はい
list_series	作品数を含むコレクションの一覧（Landscapes、NASA Spaceflight、Sailing、…）を返します。	はい
get_policies	配送、返品、支払い、税金、問い合わせに関するポリシーをJSONで返します。	はい
get_print_options	作品ごとのサイズ、額縁、価格を返します。サイズの上限はスキャンの解像度で決まります（最低100 PPI）。	はい
quote_order	税抜きの単価、小計、配送料、合計金額と、ポリシーの概要を返します。	はい
create_checkout	Stripe Checkoutリンクを作成し、checkout_urlとorder_refを返します。カードへの請求は行いません。レート制限があります。	いいえ
get_order_status	order_refに対応するチェックアウト、支払い、配送の状況を返します。個人データは返しません。	はい

入力スキーマの全容はtools.json（サーバー自身のtools/listレスポンス）に記載されています。

入力スキーマの概要

search_works      { query: string, limit?: 1-25 = 12 }
get_work          { query: string }
list_series       { }
get_policies      { }
get_print_options { work: string }
quote_order       { work: string, size?: string, frame?: string, quantity?: 1-6 = 1,
                    ship_to?: { country?: "US", state?: string, zip?: string } }
create_checkout   { work: string, size?: string, frame?: string, quantity?: 1-6 = 1, email?: string }
get_order_status  { order_ref: string }

workには、search_worksが返すascii_idスラッグ（推奨）、作品ID、/w/URL、正式なタイトル、登録番号、またはNASA IDを指定できます。sizeには、24x24などのsize_id、またはSmall、Medium、Largeを指定できます。frameには、get_print_optionsが返すframe_idを指定します。

エージェントの一般的な操作手順

1. search_works { "query": "Earthrise" }で作品を検索し、そのascii_idを取得します。
2. get_print_options { "work": "earthrise" }でサイズ、額縁、価格を確認します。
3. quote_order { "work": "earthrise", "size": "Medium" }で税抜きの合計金額を取得します。
4. create_checkout { "work": "earthrise", "size": "Medium" }で購入者用のStripe Checkoutリンクを取得します。
5. get_order_status { "order_ref": "…" }で支払いと配送の状況を確認します。

呼び出し例

curlを使った生のJSON-RPC（examples/curl.shを参照）：

curl -s -X POST https://frameanyphoto.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_works","arguments":{"query":"Earthrise","limit":1}}}'

[{"id":"AP–as08-14-2383","ascii_id":"earthrise","title":"Earthrise","artist":"NASA / Bill Anders","year":"1968",
  "series":"spaceflight","ppi":2532,"pixels":"5584 × 5584 px",
  "image":"https://media.frameanyphoto.com/art/earthrise.jpg",
  "recordUrl":"https://images.nasa.gov/details/as08-14-2383","repositoryName":"NASA Image and Video Library"}]

quote_order { "work": "earthrise", "size": "Medium" }の戻り値（抜粋）：

{"size":"Medium (24 × 24 in)","frame":"Black Metallic","unit_price_cents":15000,"shipping_cents":0,
 "total_before_tax_cents":15000,"ships_to":["US"],
 "tax":"Sales tax is added by Stripe Checkout from the shipping address."}

公式SDKを使ったNode.jsの例（examples/client.mjsを参照）：

cd examples && npm install && node client.mjs Venice

Tools: search_works, get_work, list_series, get_policies, get_print_options, quote_order, create_checkout, get_order_status

Top matches for "Venice":
- The Entrance to the Grand Canal, Venice (Canaletto, c. 1730) -> https://frameanyphoto.com/w/ct-canaletto-grand-canal
- Venice with San Giorgio Maggiore in the Moonlight (Henry Pether, by 1865) -> https://frameanyphoto.com/w/hp-san-giorgio-maggiore-moonlight
...

プロンプトの例

• 「200ドル未満で、月明かりに照らされたヴェネツィアの額入りプリントを探してください。」
• 「FrameAnyPhoto では、Earthrise はどのサイズと額縁を選べますか？」
• 「黒い額縁の中サイズのアポロ11号プリントのチェックアウトリンクを取得してください。」
• 「海辺の家に合う海のアートを提案し、2つの選択肢の見積もりを出してください。」

ストアポリシー

• 米国内の住所への送料無料。お届けまで14～21日かかります
• 郵送での30日間返金保証付き返品（返送料は購入者負担）
• Stripe Checkoutでお支払い。米国の売上税はチェックアウト時に加算されます
• 価格には額縁と送料が含まれます

機械可読形式：https://frameanyphoto.com/.well-known/policies.json

MCP Registry エントリー

server.json は、公式 MCP Registry に com.frameanyphoto/prints として公開されているエントリーです。

このリポジトリについて

このリポジトリでは、ホスト型 FrameAnyPhoto MCP サーバーについて説明し、TypeScript のソースコードを src/ で公開しています（JSON-RPC ハンドラー、ツールスキーマ、注文ツール）。また、小規模なクライアントの例も含まれています。サーバーは https://frameanyphoto.com/mcp で稼働しているため、インストールやホストは不要です。

お問い合わせ

• ウェブサイト：https://frameanyphoto.com
• メール：[email protected]
• イシュー：このリポジトリで作成してください

ライセンス

MIT