geo-explorer
Provides structured learning tracks for JavaScript at beginner and advanced levels, including study plans, code challenges, and printable certificates.
Provides structured learning tracks for Python at beginner and advanced levels, including study plans, code challenges, and printable certificates.
Provides structured learning tracks for TypeScript at beginner and advanced levels, including study plans, code challenges, and printable certificates.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@geo-explorer Show me the beginner JavaScript study plan."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Geo-Explorer
Geo-Explorer is a learning-track exploration tool that gives you structured study plans, hands-on code challenges, and printable certificates for three technologies: JavaScript, Python, and TypeScript — each at beginner (iniciante) or advanced (avancado) level.
All track data lives in a local JSON file (data/tracks.json). There are no external API calls — everything is static and self-contained.
The project exposes its functionality through two surfaces:
CLI — run commands directly from the terminal with
npm run cliMCP Server — register it in any MCP-compatible client (e.g. Claude Desktop) and call the same three tools via natural language
Prerequisites
Node.js 18+ (tested on v24)
npm 8+
Related MCP server: miyagi
Installation
git clone https://github.com/your-username/geo-explorer.git
cd geo-explorer
npm installCLI Usage
All CLI commands use the npm run cli -- prefix followed by a sub-command and its arguments.
trilha — Study plan
Prints an ordered list of modules for a given technology and level.
npm run cli -- trilha javascript iniciante
npm run cli -- trilha python avancado
npm run cli -- trilha typescript iniciantedesafio — Code challenge
Prints the challenge title, description, and a starter code block for a given track.
npm run cli -- desafio javascript iniciante
npm run cli -- desafio python avancado
npm run cli -- desafio typescript avancadocertificado — Certificate
Generates an ASCII certificate for a learner's name, technology, and level.
npm run cli -- certificado "Maria Silva" javascript iniciante
npm run cli -- certificado "João Costa" python avancado
npm run cli -- certificado "Ana Lima" typescript inicianteHelp
npm run cli -- helpMCP Server
The MCP server exposes the same three commands (trilha, desafio, certificado) as MCP tools over stdio, so any MCP-compatible client can call them.
Build the project first:
npm run buildThis compiles TypeScript to dist/ and produces dist/mcp-server.js.
Run the server:
npm startThe server stays running and listens for MCP messages on stdin/stdout. See docs/mcp-setup.md for instructions on registering it in Claude Desktop or another MCP client.
Running Tests
npm testRuns all 9 Vitest tests across three test files (track, challenge, certificate). Tests run against the real data/tracks.json — no mocking required.
Available Tools
3 toolscertificadoC
Gera um certificado de conclusão para o aprendiz.
Inputs: name (required), level (required), technology (required).
desafioA
Retorna o desafio de código para uma tecnologia e nível.
Inputs: level (required), technology (required).
trilhaB
Retorna o plano de estudos para uma tecnologia e nível.
Inputs: level (required), technology (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct artifact: study plan, code challenge, and certificate. There is no overlap or ambiguity between the three.
All tool names follow the same pattern: single lowercase Portuguese nouns (trilha, desafio, certificado). The naming is uniform and predictable.
Three tools is slightly minimal but appropriate for a focused learning-oriented server. The count is not bloated, though more tools could expand the scope.
The core journey of study plan, coding challenge, and certificate is covered. Minor gaps exist, such as no tool for listing available technologies/levels or tracking progress, but they are not fatal.
Maintenance
Related MCP Connectors
Your AI professor for Helmley courses: reads your course and progress, teaches and sends plans.
A sourced learning map your AI places you on: finds gaps you can't name, teaches step by step.
Open-source AI courses taught by your AI tutor in conversation, with progress saved by MCP tools.
Read-only access to Epivo's live course catalogue for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides educational tools for developers to learn programming concepts, review code, get best practices, compare approaches, generate learning paths, debug, explain code, and quiz themselves.8MIT
- AlicenseAqualityDmaintenanceEnables an interactive, gamified coding tutor that executes commands, provides lessons with explanations and quizzes, and tracks progress through levels and streaks, optionally with voice narration.811 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to list learning tracks, retrieve study plans, generate coding challenges, and issue fictional completion certificates through the Model Context Protocol.MIT
- AlicenseNot gradedqualityBmaintenanceGenerates personalized learning paths with day-by-day roadmaps, concepts, tasks, project ideas, and resource links based on topic, duration, and level.MIT