项目状态
本项目已被废弃并归档（DEPRECATED - PROJECT ARCHIVED），自 2026 年 1 月 25 日起不再可用。废弃原因为：项目在未经授权的情况下抓取 AllTrails 网站，违反了 AllTrails 的服务条款。应 AllTrails 首席技术官的要求，所有抓取功能已被禁用。该仓库仅出于历史留存目的以及保留 GitHub 星标而维护，代码已无法运行，不应再被使用。
AllTrails 方面就本仓库提出的理由包括：未经授权抓取/提取数据，违反其服务条款；可能涉及知识产权侵权；在未获许可的情况下再分发受版权保护的内容。如需路线数据，应使用 AllTrails 官方网站、直接联系 AllTrails 咨询 API 访问，并尊重网站服务条款与版权。
用途（原始设计）
这是一个模型上下文协议（MCP）服务器，提供对 AllTrails 数据的访问，允许通过 Claude Desktop 直接搜索徒步路线并获取详细的路线信息。
主要能力（原始设计）
- 按国家公园搜索路线
- 获取详细的路线信息，包括难度、长度、爬升高度和描述
- 来自 AllTrails 的综合路线数据，包括评分、路线类型和摘要
- 通过 MCP 协议实现与客户端的无缝集成
可用工具（原始设计）
- 按国家公园搜索路线，使用 AllTrails 数据。参数 park（必填）：公园标识，格式为 us/state/park-name，例如 us/tennessee/great-smoky-mountains-national-park。
- get_trail_details：通过 AllTrails 标识获取特定路线的详细信息。参数 slug（必填）：来自 AllTrails URL 的路线标识（/trail/ 之后的部分）。
技术规格
- 协议版本：MCP 1.9.4
- 通信方式：标准输入/输出（stdio）
- 能力：工具
- 服务器名称：alltrails-mcp
- 服务器版本：0.1.0
- 服务器命令：python3 server.py
安装方式（原始设计，现已不可用）
提供三种安装方式：
- 使用虚拟环境（推荐）：隔离依赖，避免与其他 Python 项目冲突。需克隆仓库、创建虚拟环境、安装依赖、验证安装。
- 使用系统 Python：将依赖全局安装。
- 使用 Docker：在隔离容器中运行服务器，可为 Claude Desktop 配置基于容器的服务器。
依赖要求：Python 3.8 或更高版本；可与任何 MCP 兼容客户端配合使用（作者使用 Pro 订阅的 Claude Desktop）；适用于 macOS（已测试）或其他类 Unix 系统。
客户端配置（原始设计）
Claude Desktop 配置文件位置： macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json
在配置文件中添加 MCP 服务器配置，并替换为项目目录的实际绝对路径。配置完成后需完全退出并重启 Claude Desktop。
使用示例（原始设计）
该 MCP 服务器支持自然语言，例如：“What are some good day hikes in the Smoky Mountains?”“Find me a challenging trail with waterfalls in Tennessee”“I want to hike to a summit with 360-degree views”“Show me trails that are good for photography”“Find dog-friendly trails in national parks”“What's the difficulty level of Charlies Bunion trail?”
常见公园标识示例：
- Great Smoky Mountains：us/tennessee/great-smoky-mountains-national-park
- Yosemite：us/california/yosemite-national-park
- Yellowstone：us/wyoming/yellowstone-national-park
- Grand Canyon：us/arizona/grand-canyon-national-park
- Zion：us/utah/zion-national-park
技术实现（原始设计）
- MCP 协议：使用模型上下文协议与 Claude Desktop 通信
- 网页抓取：使用 BeautifulSoup 抓取 AllTrails 网站以获取路线数据
- 数据处理：将路线信息格式化并以结构化格式返回
- 工具集成：暴露 Claude 可调用的工具，用于搜索和检索路线数据
故障排查（原始设计）
涵盖服务器无法连接、日志检查、配置文件验证、手动测试服务器、“Connection closed”错误、路径配置问题、导入错误、Python 路径错误等。可使用 pytest 运行测试套件，使用 ruff 格式化与检查代码。
限制与注意事项
本项目已废弃且不可运行（自 2026 年 1 月 25 日起）。抓取功能因违反 AllTrails 服务条款已被完全禁用。严禁在未获得网站所有者明确书面许可的情况下使用、复刻或复制本代码来抓取 AllTrails 或任何其他网站。请尊重服务条款与版权，优先使用官方 API。
