What is Hiking Mcp

Hiking MCP is a Modular Command Processor server that enables users to search for hiking routes using geographic and textual queries on Wikiloc.

Use cases

Use cases include finding hiking trails based on location, planning hiking trips, and providing route information for outdoor enthusiasts.

How to use

To use hiking-mcp, install the required dependencies, set up a virtual environment, and run the server using the command ‘uv run mcp-server.py’. Connect it with Claude for Desktop by configuring the appropriate settings in the configuration file.

Key features

Key features include integration with Wikiloc for detailed hiking route information, support for geographic and textual queries, and compatibility with Claude for Desktop.

Where to use

Hiking MCP can be used in outdoor recreation, hiking communities, travel planning, and any application that requires detailed information about hiking routes.

🏔️ Hiking MCP Server

This is an MCP (Modular Command Processor) server that allows you to search for hiking routes on Wikiloc, using geographic and textual queries.

🖥️ System Requirements

• Python 3.10 or higher
• uv installed
• Python MCP SDK 1.2.0 or higher (included with mcp[cli])
• Claude for Desktop (Windows or macOS only)

⚙️ Set Up Your Environment

1. Install uv

On Windows PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

After installation, restart your terminal so the uv command is recognized.

2. Clone and configure the project

# Clone the GitHub repository
git clone https://github.com/Adriapt/hiking-mcp.git
cd hiking-mcp

# Set up and activate a virtual environment
uv venv
.venv\Scripts\activate   # On macOS/Linux: source .venv/bin/activate

# Install required dependencies
uv add mcp[cli] httpx beautifulsoup4

▶️ Run the Server

To start the server, run:

uv run mcp-server.py

This will start the MCP server, ready to accept commands via stdio.

💻 Connect to Claude for Desktop

To use your MCP server with Claude for Desktop:

1. Ensure Claude for Desktop is installed

You can download Claude for Desktop here.

2. Open or create the configuration file

• On macOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

• On Windows (PowerShell):

code "$env:APPDATA/Claude/claude_desktop_config.json"

3. Add your MCP server configuration

{
  "mcpServers": {
    "hiking": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/hiking-mcp",
        "run",
        "mcp-server.py"
      ]
    }
  }
}

Replace /ABSOLUTE/PATH/TO/hiking-mcp with the actual full path to your project directory.

Use where uv on Windows or which uv on macOS/Linux to find the uv path if needed.