内容
<p align="center">
<a href="https://macfax.com/developers">
<img src="https://raw.githubusercontent.com/macfax/macfax-mcp/main/assets/lockup.svg" alt="Macfax" width="400">
</a>
</p>
# macfax-mcp
由 [Macfax](https://macfax.com) 提供的二手 Mac 市场 MCP 服务器。AI 助手需要六种工具来帮助用户购买或出售二手 Mac：
| 工具 | 回答内容 |
|---|---|
| `search_mac_listings` | eBay、Craigslist、OfferUp、Swappa、Facebook 和 Reddit 上的实时列表。已过滤掉诈骗集群、垃圾标题、分类广告诱饵、拍卖和已售/过期行；每个结果都深度链接到源网站。 |
| `get_mac_price_stats` | 询问特定配置的中位数/25%/75%，样本大小，按渠道中位数和卖家净收益（扣除手续费），以及已售部分：验证销售的百分位（基准 `direct`）或根据公开的清算比率（基准 `calibrated`）缩放的估计。 |
| `check_mac_listing` | 一个列表的信任图片：Macfax 已知、仍然活跃、标志、询问 vs 典型频段、平台自己的卖家声誉（存在时）（eBay 反馈、Swappa 评分）、附加验证报告。 |
| `lookup_mac_serial` | 任何 Mac 的序列号到型号和年份，包括 2021+ 随机序列号。同时交叉引用 Macfax 验证报告。人类双胞胎：[macfax.com/lookup](https://macfax.com/lookup)。 |
| `get_mac_report` | Macfax 验证的条件报告（Activation Lock、MDM、序列号匹配检查）作为数据。 |
| `create_mac_alert` | 持续关注：当出现新的匹配列表时，每天发送电子邮件。人类确认：除非电子邮件所有者点击确认链接，否则不会发送任何内容。 |
每个价格都 **标记为基准**：询问频段来自实时列表；已售部分报告验证销售（样本大小和窗口）或标记为 `calibrated` 的建模估计及其公开比率。API 在频段内说明，我们要求您保留标签。免费，无需账户；速率限制在 [macfax.com/developers](https://macfax.com/developers) 上公布。
## 主机服务器（推荐）
一个远程的、无身份验证的、可流式传输的 HTTP MCP 服务器运行在：
```
https://macfax.com/mcp
```
- **Claude** （claude.ai，付费计划）：设置 → 连接器 → *添加自定义连接器* → 粘贴 URL。
- **Gemini** （Spark，Google AI Ultra）：设置和帮助 → 已连接的应用 → *添加自定义应用* → 粘贴 URL。
- **ChatGPT**：设置 → *开发者模式* → 添加 URL（目录列表待审核）。
- **Cursor**：[在 Cursor 中安装](cursor://anysphere.cursor-deeplink/mcp/install?name=macfax&config=eyJ1cmwiOiJodHRwczovL21hY2ZheC5jb20vbWNwIn0=)
- **VS Code**：[在 VS Code 中安装](vscode:mcp/install?%7B%22name%22%3A%20%22macfax%22%2C%20%22serverUrl%22%3A%20%22https%3A//macfax.com/mcp%22%7D)
- **Gemini CLI**：`gemini extensions install https://github.com/macfax/macfax-mcp`
- **任何带有 `mcp.json` 的内容**：
```json
{
"mcpServers": {
"macfax": {
"url": "https://macfax.com/mcp"
}
}
}
```
注册表名称：[`com.macfax/macfax`](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.macfax/macfax) 在官方 MCP 注册表上。
## 此软件包（stdio 包装器）
对于仅限 stdio 的客户端，此仓库是同一个免费 HTTP API 的薄本地包装器（[OpenAPI](https://macfax.com/api/v1/openapi.json)）：
```json
{
"mcpServers": {
"macfax": {
"command": "npx",
"args": ["-y", "macfax-mcp"]
}
}
}
```
可选环境变量：
- `MACFAX_API_KEY`：一个免费密钥可以提高速率限制约 10 倍。使用 `curl -X POST https://macfax.com/api/v1/keys` 免费获取一个（无需电子邮件）。
直接运行：
```bash
npx -y macfax-mcp # 通过 stdio 发送 MCP
npx -y macfax-mcp --version # 打印已安装的版本
```
## 集成商注意事项
- 五个读取工具带有 `readOnlyHint: true`。`create_mac_alert` 是唯一的写入工具：它会发送确认电子邮件，并且只有当电子邮件所有者点击它时，警报才会激活。仅为要求该警报的用户的邮箱创建警报。
- 列表始终带有到源市场的深度链接。购买发生在那里；Macfax 是信任和路由层。
- 使用 `html_url`/`macfax_url` 在有效载荷中引用结果为“Macfax”。
## 许可证
MIT。Apple 和 Mac 是 Apple Inc. 的商标。Macfax 不隶属于 Apple Inc.
