convez.ai
MCP ServerIntegração & APIsIntermediário
dreamiurg

Mountaineers MCP Server

dreamiurg/mountaineers-mcp

Busque trilhas, cursos e relatórios do Mountaineers direto do Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que integra o Claude com mountaineers.org, permitindo buscar atividades, cursos, relatórios de trilhas e acessar dados da conta do usuário. Funciona tanto para buscas públicas quanto para acesso autenticado ao histórico pessoal, inscrições e badges de montanhismo.

Instalação

$npx convez-ai dreamiurg/mountaineers-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 1 semana
Versão
v1.12.2
Issues abertas
3
Contribuidores
3

Casos de uso

  • Encontrar atividades de escalada e trilhas por dificuldade, data e localização
  • Pesquisar cursos e clínicas de montanhismo disponíveis
  • Consultar relatórios de trilhas e ganho de elevação
  • Acessar histórico pessoal de atividades, inscrições e badges (com autenticação)

Veredito

Integração bem executada e específica para a comunidade de montanhismo. Oferece acesso tanto público (busca) quanto autenticado (conta), com setup simples via Claude Desktop. Caso de uso nicho mas polido.

README

A tradução para o português deste README ainda está na fila.

Mountaineers MCP Server

CI npm

What is this?

This lets AI assistants like Claude and ChatGPT search and browse mountaineers.org on your behalf. Instead of clicking through the website, you can ask questions in plain English:

  • "Find me a beginner-friendly day hike near Seattle this weekend"
  • "What scrambles are available in August?"
  • "Show me trip reports for Mount Pilchuck"
  • "What's the elevation gain on the Mount Si trail?"
  • "What activities am I signed up for?"
  • "What badges have I earned?"

The AI reads the Mountaineers website, understands the results, and gives you a conversational answer -- no manual searching required. Read the full story: I Built an MCP Server for Mountaineers.org.

What can it do?

Search the website (no login needed):

  • Search activities by type, branch, difficulty, date, and more
  • Search courses, clinics, and seminars
  • Browse trip reports
  • Search routes and places
  • Get full details for any activity, trip report, route, or course

Access your account (with your login):

  • See your upcoming and past activities
  • See your completed activity history
  • See your course enrollments
  • View your earned badges and certifications
  • View member profiles and activity rosters

Setup

Follow the instructions for your AI app below.

Claude Desktop

  1. Download mountaineers-mcp-X.Y.Z.mcpb from the latest release
  2. Open Claude Desktop → Settings → Extensions → Install Extension
  3. Select the downloaded .mcpb file
  4. Enter your mountaineers.org credentials if you want account access (optional)

That's it -- no Node.js install required.

Requires Node.js 18+.

  1. Go to Settings > Developer > Edit Config
  2. Paste this and save:
{
  "mcpServers": {
    "mountaineers": {
      "command": "npx",
      "args": ["-y", "mountaineers-mcp"]
    }
  }
}
  1. Quit and reopen Claude Desktop (not just close the window -- fully quit)

To also access your account (activity history, rosters, etc.), add your mountaineers.org credentials:

{
  "mcpServers": {
    "mountaineers": {
      "command": "npx",
      "args": ["-y", "mountaineers-mcp"],
      "env": {
        "MOUNTAINEERS_USERNAME": "your-username",
        "MOUNTAINEERS_PASSWORD": "your-password"
      }
    }
  }
}

Your credentials stay on your computer and are only sent to mountaineers.org.

ChatGPT Desktop

ChatGPT Desktop supports MCP through Developer Mode, but only remote HTTP servers -- it cannot run local command-line tools like Claude Desktop can. To use this server with ChatGPT Desktop, you would need to run it behind a tunnel (e.g., mcp.run or ngrok). This is not yet streamlined; we plan to add Streamable HTTP transport in a future release.

Requires ChatGPT Plus, Pro, Team, or Enterprise.

Claude Code (CLI)

Run this in your terminal:

claude mcp add mountaineers -- npx -y mountaineers-mcp

Or add to your .mcp.json:

{
  "mcpServers": {
    "mountaineers": {
      "command": "npx",
      "args": ["-y", "mountaineers-mcp"],
      "env": {
        "MOUNTAINEERS_USERNAME": "your-username",
        "MOUNTAINEERS_PASSWORD": "your-password"
      }
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.mountaineers]
command = "npx"
args = ["-y", "mountaineers-mcp"]

[mcp_servers.mountaineers.env]
MOUNTAINEERS_USERNAME = "your-username"
MOUNTAINEERS_PASSWORD = "your-password"

Or use the CLI:

codex mcp add mountaineers -- npx -y mountaineers-mcp

Tools reference

Public (no login required)

ToolDescription
search_activitiesSearch activities with filters (type, branch, difficulty, date, day of week)
search_coursesSearch courses, clinics, and seminars
search_trip_reportsSearch trip reports by text and activity type
search_routesSearch routes and places with filters (activity type, difficulty, climbing category)
get_activityGet full activity details (leader notes, route, equipment)
get_trip_reportGet trip report details (conditions, route info)
get_routeGet route details (difficulty, elevation, directions, maps, related routes)
get_courseGet course details (schedule, pricing, leaders, badges earned)

Authenticated (login required)

ToolDescription
whoamiGet your name, profile URL, and member slug
get_my_activitiesYour registered activities (upcoming) with filtering
get_my_coursesYour course enrollments with filtering
get_activity_historyYour completed activity history with filtering by result, type, and date
get_my_badgesYour earned badges and certifications with dates
get_member_profileView a member's profile, badges, and committees
get_activity_rosterSee who's signed up for an activity

Privacy

Your credentials are stored locally on your computer and are only sent to mountaineers.org to log in. They are never sent to any AI provider or third party.

Development

npm install
npm run dev          # Run from TypeScript sources via tsx (no build step)
npm run check        # Typecheck + lint
npm test             # Run tests
npm run ci           # Full CI: check + coverage + build

Other Mountaineering & Outdoors Tools

I climb, scramble, and hike a lot, and I keep building tools around it. If this one's useful to you, the others might be too:

  • mountaineers-assistant -- Chrome extension that syncs your mountaineers.org activity history and shows you stats, trends, and climbing partners you can't see on the site.
  • peakbagger-cli -- Command-line access to PeakBagger.com. Search peaks, check elevation and prominence, browse ascent stats. Outputs JSON for piping into other tools.
  • claude-mountaineering-skills -- Claude Code plugin that generates route beta reports by pulling conditions, forecasts, and trip reports from multiple mountaineering sites.

License

MIT

Ver o original no GitHub

Bom para

Relacionados