Back to MCP directory
publicPublicdnsLocal runtime

mcp-untappd-server

一个基于Node.js的Untappd API查询MCP服务器,提供啤酒搜索、详情查询功能

article

README

🚀 Untappd 模型上下文协议服务器

本项目是一个使用 node 编写的简单 MCP 服务器,主要用于查询 Untappd API。不过很遗憾,该平台目前不再接受新的 API 密钥注册。

✨ 主要特性

目前,该服务器仅支持以下三种工具:

  • search_beer:可在 Untappd 上搜索啤酒。
  • get_beer_info:通过搜索得到的 beer_id,获取详细的啤酒信息。
  • get_user_checkins当前无法使用,此功能用于返回用户的签到记录。

🚀 快速开始

开发

  • 安装依赖项
npm install
  • 构建服务器
npm run build
  • 带自动重建开发
npm run watch

安装

若要与 Claude Desktop 一起使用,需添加服务器配置。不同系统的配置文件路径如下:

  • MacOS~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows%APPDATA%/Claude/claude_desktop_config.json

配置文件内容如下:

{
  "mcpServers": {
    "untappd-server": {
      "command": "/path/to/untappd-server/build/index.js"
    }
  }
}

调试

由于 MCP 服务器通过 stdio 通信,调试可能具有一定挑战性。我们推荐使用 MCP Inspector,它作为包脚本可用:

npm run inspector

Inspector 将提供一个可在浏览器中访问调试工具的 URL。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client