摘要
通过任何 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 + Gemini
通过任何 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 — 在 Gemini 中添加连接器
Gemini CLI 运行在你的电脑上，因此可以使用本地 endpoint：
gemini mcp add --transport http untappd http://localhost:4000/mcp/<server-id> -H "X-API-Key: <your-api-key>"
服务器会保存到当前项目的 .gemini/settings.json；加上 -s user 可保存到 ~/.gemini/settings.json，对所有项目生效。启动 gemini 并运行 /mcp，即可看到 Untappd 的工具。
可用工具
| 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
Gemini 1.5 Pro 或 2.x 支持 MCP 吗? 支持 — Gemini CLI ≥ 0.4 与 Vertex AI tools API 均接受带自定义请求头的 MCP httpUrl 连接器。
为什么 AnythingMCP Cloud 上没有 Untappd？ Untappd 会拒绝来自数据中心 IP 地址的请求。AnythingMCP Cloud 运行在数据中心，因此每次调用都会失败。部署在家庭或办公网络上的 AnythingMCP 实例通常可以正常使用。
下一步
这份指南对你有帮助吗?
