mcp-roadmapsh
Provides tools to list and retrieve developer roadmaps, topic markdown, best practices, interview questions, project ideas, videos, and local progress tracking using the roadmap.sh platform.
Click on "Install 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., "@mcp-roadmapshshow me the backend development roadmap"
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.
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 markdownGitHub 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.
Related MCP server: Aindreyway MCP Codex Keeper
Quick start
Claude Code (one command)
# Once published to npm:
claude mcp add roadmapsh -- npx -y mcp-roadmapsh
# Works today, straight from GitHub (npx builds it for you):
claude mcp add roadmapsh -- npx -y github:aissablk1/mcp-roadmapshAny MCP client (JSON config)
{
"mcpServers": {
"roadmapsh": { "command": "npx", "args": ["-y", "mcp-roadmapsh"] }
}
}Replace mcp-roadmapsh with github:aissablk1/mcp-roadmapsh to run the latest
GitHub version before the npm release.
From source (contributors)
git clone https://github.com/aissablk1/mcp-roadmapsh.git
cd mcp-roadmapsh
npm install # `prepare` builds dist/ automatically
npm test # end-to-end test against real data
node dist/index.js # stdio MCP server
npm run inspect # open the MCP InspectorTools
Tool | Purpose |
| Connectivity + cache/state status |
| List all roadmap slugs |
| Roadmap graph by slug ( |
| Topic markdown + links (by |
| Export a whole roadmap as markdown/text |
| Search slugs by keyword within a scope |
| Best-practice guides |
| Interview question groups |
| Practice project ideas |
| Video resources |
| Mark a topic learning / done / skip (local) |
| Completion percent for a roadmap |
| Recommend the next topic to learn |
Configuration (env)
Variable | Default | Purpose |
|
| HTTP cache directory |
|
| Cache TTL |
|
| Progress state |
|
| HTTP timeout |
|
| GitHub owner of the developer-roadmap repo |
|
| developer-roadmap branch |
| — | Optional, raises GitHub API rate limit |
Publishing (maintainers)
npm publish # to npmjs.com (npm login required first)
npx -y @modelcontextprotocol/publisher publish # to the official MCP registry (server.json)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
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityDmaintenanceA beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.Last updated33766Apache 2.0
- Alicense-qualityDmaintenanceAn intelligent MCP server that serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices.Last updated920MIT
- Flicense-qualityDmaintenanceAI-powered MCP server that transforms learning by finding best YouTube tutorials, generating personalized learning paths, and tracking progress for any tech skill.Last updated9
- Flicense-qualityCmaintenanceThis MCP server exposes programming topic data and tools (search, practice suggestions) to help AI agents answer study questions, like 'How to study Python decorators?'.Last updated
Related MCP Connectors
A MCP server built for developers enabling Git based project management with project and personal…
Official MCP server for Lovable, the AI-powered full-stack app builder.
MCP server aggregating developer infrastructure deals, free tiers, and startup programs
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/aissablk1/mcp-roadmapsh'
If you have feedback or need assistance with the MCP directory API, please join our Discord server