🏔️ Hiking MCP Server

🏔️ 徒步 MCP 服务

这是一个 MCP（模块化命令处理器）服务，可通过地理和文本查询，在 Wikiloc 上搜索徒步路线。

---

🖥️ 系统要求

• Python 3.10 或更高版本
• 已安装 uv
• Python MCP SDK 1.2.0 或更高版本（包含在 mcp[cli] 中）
• Claude for Desktop（仅限 Windows 或 macOS）

---

⚙️ 设置环境

1. 安装 uv

在 Windows PowerShell 中：

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

安装后，重启终端，以便识别 uv 命令。

---

2. 克隆并配置项目

# 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

---

▶️ 运行服务

要启动服务，请运行：

uv run mcp-server.py

这将启动 MCP 服务，使其能够通过 stdio 接收命令。

---

💻 连接到 Claude for Desktop

要将 MCP 服务与 Claude for Desktop 配合使用：

1. 确认已安装 Claude for Desktop

你可以在此下载 Claude for Desktop。

2. 打开或创建配置文件

• 在 macOS 上：

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

• 在 Windows 上（PowerShell）：

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

3. 添加 MCP 服务配置

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

将 /ABSOLUTE/PATH/TO/hiking-mcp 替换为项目目录的实际完整路径。

如果需要查找 uv 的路径，可在 Windows 上使用 where uv，或在 macOS/Linux 上使用 which uv。