ALT/FNDATA

ALT/FNDATA MCP Server

将 AI 助手连接到奢侈品和收藏品拍卖数据。用自然语言查询来自全球 100 多家拍卖行的腕表、珠宝、裸石、手袋、汽车、摩托车、飞机、葡萄酒和威士忌、精品艺术品、艺术作品、设计品、时尚单品、鞋履、汽车纪念品、书籍、硬币、香水、配饰、乐器及其他车辆。

它采用开放的 Model Context Protocol（MCP），因此可与 Claude、ChatGPT、Gemini、Perplexity 以及其他支持 MCP 服务的助手和开发工具配合使用。

快速开始

1. 获取 API Key

在 ALT/FNDATA 应用的 API Key & MCP 中获取密钥。

2a. 连接托管服务（无需安装）

在任何支持远程 MCP 服务（通常称为自定义连接器）的助手中，使用以下 URL 添加连接器：

https://mcp.altfndata.com/mcp

如果系统询问身份验证方式，请选择 OAuth。随后会显示登录页面，要求输入 ALT/FNDATA API key。

• **Claude：**设置 → 连接器 → 添加自定义连接器。
• **ChatGPT：**将其添加为自定义连接器（开发者模式）。ChatGPT 仅连接托管服务，因此请使用此选项。
• **Perplexity：**设置 → 连接器 → 使用上方的 URL 添加自定义连接器。
• **Gemini 应用：**设置 → 已连接的应用 → 使用上方的 URL 添加自定义应用（个人 Google 账号）。
• **Gemini Enterprise：**管理员为组织添加一次 ALT/FNDATA。请参阅下方的 Gemini Enterprise 管理员设置。

菜单名称和套餐可用性由各助手决定，并会随时间变化；如果步骤不一致，请查阅其帮助页面。

Gemini Enterprise（管理员设置）

Gemini Enterprise 通过自定义 MCP 服务数据存储进行连接，由管理员为组织设置一次。

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 控制台中，添加自定义 MCP 服务数据存储，并填写以下值：

   字段	值
   MCP 服务 URL	https://mcp.altfndata.com/mcp
   授权 URL	https://mcp.altfndata.com/authorize
   Token URL	https://mcp.altfndata.com/token
   客户端 ID	第 1 步中的 client_id
   客户端密钥	第 1 步中的 client_secret
   范围	read
   启用 PKCE	已勾选

3. 随后，每位用户都可以从 Gemini 连接，并使用自己的 ALT/FNDATA API key 登录。客户端 ID 和密钥仅用于标识贵组织的 Gemini Enterprise；它们本身不会授予任何数据访问权限。

Google 关于设置自定义 MCP 服务的指南介绍了控制台中的相关界面。

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 只 Rolex 腕表”
• “Christie's 售出了多少件 Hermes 手袋？”
• “提供 Phillips 售出 Patek Philippe 腕表的市场统计数据”
• “过去五年 Hermes Birkin 的价格走势如何？”
• “查询 Rolex Daytona 116500 白色表盘的价格”
• “在整个市场中搜索售价超过 $50k 的 Burma 红宝石戒指”
• “有哪些散装蓝宝石曾在拍卖会上售出？”（使用 gems，而非 jewelry）

可用工具

全部 9 个工具均为只读，并标注了 readOnlyHint: true。任何工具都不会修改数据。

工具	描述
list_tables	列出 20 个可用表，并提供实时描述和列数
get_table_schema	显示某个表的列名称和类型
query_table	使用筛选条件、排序、字段选择和分页查询表
market_stats	汇总某个表或筛选后细分市场的成交价：成交数量、中位数、第 25/75 百分位数、平均值、最低/最高价、成交日期范围，以及按成交量排名的供应商
price_trend	显示成交价随时间的变化，可按年、季度或月分组（每个时段的成交数量、中位数、平均值）
price_check	根据可比成交记录估算单件商品的合理价格区间，并提供来源链接。实时可比类别：手袋、腕表、汽车
search	一次性跨所有类别进行全市场关键词搜索，并按成交价合并结果。不指定类别时，会搜索全部 20 个表
market_index	预先计算的品牌或型号级价格指数（低位 / 第 25 百分位 / 中位数 / 第 75 百分位 / 高位、样本量、趋势）。覆盖类别：手袋、腕表、汽车
list_alerts	只读查看价格提醒，或获取启用提醒的说明。请参阅下文“价格提醒为只读”

每个工具都带有 readOnlyHint 和 openWorldHint。

价格提醒为只读

价格提醒关联已登录的 ALT/FNDATA 账户（Cognito 登录），而非 API 密钥。MCP 仅使用 API 密钥进行身份验证，因此无法创建或启用提醒，使用 API 密钥的调用者也无法访问提醒动态。list_alerts 因此会报告已触发的提醒（当会话能够访问提醒动态时），或提供在 app.altfndata.com 中设置提醒的说明。各计划的提醒额度：免费版 0 条，注册用户 1 条，收藏家版 10 条，专业版 100 条，Membership 套餐包含提醒。

功能与套餐建议

部分工具响应可能会附带一行简短的“💡”提示，推荐搭配使用的 ALT/FNDATA 产品或套餐升级。每次响应最多出现一次，且仅在确实遇到套餐限制时（例如套餐不包含某个表，或行数额度已用尽），或作为相关功能提示时显示；无限量账户和 comp 账户不会显示。这不会改变返回的数据。

查询功能

• 筛选任意列，支持以下运算符：eq、neq、gt、gte、lt、lte、like、in、not_in、is_null、is_not_null
• 排序任意列，支持升序或降序
• 选择要返回的特定字段
• 使用 limit/offset 分页（每次请求最多 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 密钥，因此无需本地安装。

自托管远程服务

要以远程（HTTP）模式运行 MCP 服务：

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