Localgym Uk Gym Search Mcp Server

LocalGym MCP Server

公開されている LocalGym Agent API を使用して、英国のジムを検索、比較、おすすめする読み取り専用 MCP サーバーです。

• ウェブサイト：https://localgym.uk
• エージェント／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 サーバーは、LocalGym の非公開ウェブサイトのコードベースを公開することなく、AI アシスタントやエージェントのワークフローから地域のジムを検索できる、出典を明示できる小規模なインターフェースを提供します。

ツール

ツール	説明
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 クライアントから stdio 経由で 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