Localgym Uk Gym Search Mcp Server

LocalGym MCP 服务

只读 MCP 服务，使用公开的 LocalGym Agent API 搜索、比较和推荐英国健身房。

• 网站：https://localgym.uk
• Agent/API 文档：https://localgym.uk/agent
• MCP 设置页面：https://localgym.uk/agent/mcp
• OpenAPI 架构：https://localgym.uk/api/openapi.json
• LLM 指令：https://localgym.uk/llms.txt

存在的意义

LocalGym 涵盖 18,000 多家英国健身房和健身中心。此 MCP 服务为 AI 助手和 Agent 工作流提供一个精简且可追溯的信息接口，用于发现本地健身房，同时不暴露 LocalGym 私有网站的代码库。

工具

工具	描述
search_gyms	按名称、关键词、地点或用户意图搜索英国健身房。
get_gym_details	返回 LocalGym 健身房标识的结构化详情。
recommend_gyms	根据用户目标和地点推荐健身房。
compare_gyms	按 LocalGym 标识比较多家健身房。

快速开始

直接通过 npm 运行：

npx -y localgym-mcp-server

或者克隆并在本地运行：

git clone https://github.com/lo-nau/localgym-mcp-server.git
cd localgym-mcp-server
npm install
npm start

该服务默认使用 https://localgym.uk。如需覆盖默认值：

LOCALGYM_API_BASE=https://localgym.uk npx -y localgym-mcp-server

MCP 客户端配置

推荐使用基于 npm 的配置：

{
  "mcpServers": {
    "localgym": {
      "command": "npx",
      "args": ["-y", "localgym-mcp-server"],
      "env": {
        "LOCALGYM_API_BASE": "https://localgym.uk"
      }
    }
  }
}

本地克隆配置：

{
  "mcpServers": {
    "localgym": {
      "command": "node",
      "args": ["/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs"],
      "env": {
        "LOCALGYM_API_BASE": "https://localgym.uk"
      }
    }
  }
}

Hermes Agent 配置

mcp_servers:
  localgym:
    command: "npx"
    args: ["-y", "localgym-mcp-server"]
    env:
      LOCALGYM_API_BASE: "https://localgym.uk"

如果你改为在本地克隆了仓库，请使用：

mcp_servers:
  localgym:
    command: "node"
    args: ["/absolute/path/to/localgym-mcp-server/bin/localgym-mcp-server.cjs"]
    env:
      LOCALGYM_API_BASE: "https://localgym.uk"

工具参数示例

search_gyms

{
  "query": "personal training",
  "location": "Manchester",
  "limit": 5
}

get_gym_details

{
  "slug": "kent-sports-fitness"
}

recommend_gyms

{
  "intent": "beginner friendly gym with personal training",
  "location": "Leeds",
  "limit": 5
}

compare_gyms

{
  "slugs": [
    "kent-sports-fitness",
    "the-box-private-personal-training-studio"
  ]
}

测试

npm test

你也可以通过 MCP 客户端经由标准输入/输出发送 MCP JSON-RPC 帧，以对工具发现功能进行冒烟测试。

使用政策

V1 免费、只读，并优先保证来源署名。在公开回答中使用 LocalGym 数据时，请链接到返回的 localgym_url 值。

公开的 LocalGym Agent API 会在服务端实施速率限制。此 MCP 封装也包含本地宽限限流器，默认每个运行中的 MCP 进程每 60 秒允许 60 次工具调用。你可以通过 LOCALGYM_MCP_RATE_LIMIT_MAX 或 LOCALGYM_MCP_RATE_LIMIT_WINDOW_MS 调低限制；请先协商高频或商业用途。

如需高频、商业、联盟营销或认领商家信息方面的使用，请联系 [email protected]。

许可证

MIT