返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端