🏔️ Hiking MCP Server

🏔️ ハイキング MCP サーバー

これは、地理情報やテキストによるクエリを使用して、Wikiloc 上のハイキングルートを検索できる MCP（Modular Command Processor）サーバーです。

---

🖥️ システム要件

• 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 に接続する

Claude for Desktop で MCP サーバーを使用するには、次の手順に従ってください。

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 を、プロジェクトディレクトリの実際の絶対パスに置き換えてください。

必要に応じて、Windows では where uv、macOS/Linux では which uv を使用して、uv のパスを確認してください。