摘要
通过任何 AI 助手搜索 Untappd 的啤酒数据库。按名称、酿酒厂或风格查找啤酒；读取带评分的啤酒详情；查询场所和签到记录。4 个工具，需要免费的 Untappd API client_id + client_secret。
试试这样问
Untappd 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
仅限自托管。 Untappd 会拒绝来自数据中心 IP 地址的请求，而 AnythingMCP Cloud 运行在数据中心，因此该连接器无法在 AnythingMCP Cloud 上使用。它可以在你自己运行的 AnythingMCP 实例上工作，前提是该实例所在的电脑或服务器使用普通的家庭或办公网络。
Untappd + Claude
通过任何 AI 助手搜索 Untappd 的啤酒数据库。按名称、酿酒厂或风格查找啤酒；读取带评分的啤酒详情；查询场所和签到记录。4 个工具，需要免费的 Untappd API client_id + client_secret。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
UNTAPPD_CLIENT_ID, UNTAPPD_CLIENT_SECRET
步骤 1 — 获取凭证
This connector wraps Untappd's REST API (api.untappd.com/v4).
Setup: Untappd requires a free API client_id + client_secret. Apply for them at https://untappd.com/api/register. Approval is usually fast.
Provide:
UNTAPPD_CLIENT_ID— your app's client IDUNTAPPD_CLIENT_SECRET— your app's client secret
What's exposed: public, unauthenticated endpoints (no user OAuth needed for basic search + lookup). For per-user data (your check-ins, your wishlist), you'd need OAuth — not included in this connector.
Rate limits: Untappd publishes 100 req/hour per client. The connector does not auto-retry on 429; respect the limit.
…(continued in the in-app connector instructions)
步骤 2 — 安装 adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
- 打开
http://localhost:3000并注册。第一个账户会成为管理员。 - 打开连接器商店（
http://localhost:3000/connectors/store），选择 Untappd，填写它要求的凭证（有些连接器不需要），然后安装。 - 在 MCP Servers 中创建一个服务器，并把 Untappd 连接器分配给它。在该服务器的页面上复制 MCP endpoint（
http://localhost:4000/mcp/<server-id>），并在 API keys 下生成一个密钥。
快速启动只监听 localhost。如果需要一个其他人或云端 AI 客户端也能访问的实例，请克隆仓库并运行 ./setup.sh，它会配置域名、HTTPS 和 OAuth（部署指南）。
第 3 步 —— 在 Claude 中添加 Untappd 连接器
Claude 连接 MCP 服务器有两种方式，其中只有一种适用于 localhost 快速启动。
Claude Code 运行在你的电脑上，因此可以直接使用本地 endpoint：
claude mcp add --transport http untappd http://localhost:4000/mcp/<server-id> --header "X-API-Key: <your-api-key>"
运行 claude mcp list 检查是否已连接。
Claude.ai 和 Claude Desktop 通过自定义连接器添加远程服务器：进入 Customize → Connectors，点击 +，选择 Add custom connector（在 Team 和 Enterprise 套餐中，需要所有者先在 Organization settings → Connectors 中添加）。Claude 是从 Anthropic 的云端而不是从你的电脑建立这个连接的，所以 localhost 地址在这里不可用。你需要一个具有公网 HTTPS 地址的 AnythingMCP 实例（见上文的 ./setup.sh），并且它所在的网络要被 Untappd 接受。粘贴该实例的 MCP endpoint，并在 Claude 提示时登录 AnythingMCP。
可用工具
| Tool | What it does |
|---|---|
untappd_search_beer | Search Untappd for beers by free-text query (name, brewery, style) |
untappd_get_beer | Full detail of one beer by ID — brewery, style, ABV, IBU, ratings, recent check-ins, label |
untappd_search_brewery | Search Untappd for breweries by free-text query |
untappd_get_brewery | Full detail of one brewery by ID — location, beer list, social stats |
FAQ
为什么 AnythingMCP Cloud 上没有 Untappd？ Untappd 会拒绝来自数据中心 IP 地址的请求。AnythingMCP Cloud 运行在数据中心，因此每次调用都会失败。部署在家庭或办公网络上的 AnythingMCP 实例通常可以正常使用。
下一步
这份指南对你有帮助吗?
