
Mcp Roadmapsh
io.github.aissablk1Published by GitHub account aissablk1v0.2.0Updated Nov 3, 2026
MCP server for roadmap.sh: roadmaps, best practices, interview questions, projects & progress
Overview
Local MCP server that gives an assistant roadmap.sh developer roadmaps, best practices, interview questions, project ideas and local learning progress.
- What you can do
- List and search roadmap slugs, and fetch a roadmap graph as outline or raw data
- Read topic markdown and links by node ID or query, and export a whole roadmap as markdown or text
- Browse best-practice guides, interview question groups, practice project ideas and video resources
- Mark topics as learning, done or skipped locally, check completion percentage and get the next recommended topic
- Run a diagnostic check of connectivity and cache/state status
- When to use it
- Useful when you want an assistant to guide developer learning along roadmap.sh paths: exploring a roadmap, pulling topic notes, quizzing with interview questions, picking practice projects, or tracking which topics are finished.
- Requirements
- Runs as a local process via npx, so Node.js 20 or newer is required. Network access to roadmap.sh and GitHub is needed. Optional environment variables set cache and state directories, cache TTL, HTTP timeout, GitHub owner and branch, and GITHUB_TOKEN to raise GitHub API rate limits.
Installation
In SourceWeft
- Open Mcp Roadmapsh in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
mcp-roadmapsh
MCP server for roadmap.sh — developer roadmaps, best
practices, interview questions, project ideas, videos, and local progress
tracking. Built on the official @modelcontextprotocol/sdk (TypeScript / stdio).
All data comes from official, public sources — no scraping, no mock data:
https://roadmap.sh/{slug}.json— rendered roadmap graphsraw.githubusercontent.com/nilbuild/developer-roadmap— topic markdown- GitHub contents API — dynamic slug listings
Prerequisite
Node.js 20 or newer (node --version to check). That is
the only requirement — npx (bundled with Node) handles the rest, no manual
clone or build needed.
Quick start
Claude Code (one command)
Any MCP client (JSON config)
Replace mcp-roadmapsh with github:aissablk1/mcp-roadmapsh to run the latest
GitHub version before the npm release.
From source (contributors)
Tools
Configuration (env)
Publishing (maintainers)
The package ships mcpName and a server.json so it can be listed in the
official Model Context Protocol registry.
License
MIT — Aïssa BELKOUSSA
Source: README.md at commit a41a2d5
Tools
0Version history
1- v0.2.0LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts