English Français العربية

io.github.aissablk1/mcp-roadmapsh

Registre officiel Autres

MCP server for roadmap.sh: roadmaps, best practices, interview questions, projects & progress

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package mcp-roadmapsh
Claude Code 
claude mcp add mcp-roadmapsh -- npx -y mcp-roadmapsh@0.2.0
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-roadmapsh": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-roadmapsh@0.2.0"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. mcp-roadmapsh
  2. Prerequisite
  3. Quick start
  4. Tools
  5. Configuration (env)
  6. Publishing (maintainers)
  7. License

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 graphs
  • raw.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)
# 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-roadmapsh
Any 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 Inspector

Tools

ToolPurpose
roadmap_diagnoseConnectivity + cache/state status
roadmap_listList all roadmap slugs
roadmap_getRoadmap graph by slug (outline or raw)
roadmap_topicTopic markdown + links (by nodeId or query)
roadmap_exportExport a whole roadmap as markdown/text
roadmap_searchSearch slugs by keyword within a scope
best_practices_list / best_practices_getBest-practice guides
questions_list / questions_getInterview question groups
projects_list / project_getPractice project ideas
videos_listVideo resources
progress_markMark a topic learning / done / skip (local)
progress_statusCompletion percent for a roadmap
progress_nextRecommend the next topic to learn

Configuration (env)

VariableDefaultPurpose
ROADMAPSH_CACHE_DIR~/.cache/mcp-roadmapshHTTP cache directory
ROADMAPSH_CACHE_TTL_MS86400000 (24 h)Cache TTL
ROADMAPSH_STATE_DIR~/.local/state/mcp-roadmapshProgress state
ROADMAPSH_TIMEOUT_MS20000HTTP timeout
ROADMAPSH_OWNERnilbuildGitHub owner of the developer-roadmap repo
ROADMAPSH_BRANCHmasterdeveloper-roadmap branch
GITHUB_TOKEN—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

Questions fréquentes

Qu'est-ce que io.github.aissablk1/mcp-roadmapsh ?

MCP server for roadmap.sh: roadmaps, best practices, interview questions, projects & progress

Comment installer io.github.aissablk1/mcp-roadmapsh ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add mcp-roadmapsh -- npx -y mcp-roadmapsh@0.2.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.aissablk1/mcp-roadmapsh ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.aissablk1/mcp-roadmapsh est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.aissablk1/mcp-roadmapsh ?

Il est publié par aissablk1. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.