Mcp Roadmapsh

io.github.aissablk1由 GitHub 账号 aissablk1 发布v0.2.0更新于 Nov 3, 2026

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

已验证STDIO仅桌面知识与记忆开发者工具

概览

AI 生成的概览

本地 MCP 服务器,让助手获取 roadmap.sh 的开发者路线图、最佳实践、面试题、项目创意,并在本地记录学习进度。

可以做什么
  • 列出并搜索路线图 slug,以 outline 或 raw 形式获取路线图图谱
  • 按节点 ID 或关键词读取主题 Markdown 与链接,并把整份路线图导出为 Markdown 或纯文本
  • 浏览最佳实践指南、面试题组、练习项目创意和视频资源
  • 在本地把主题标记为学习中、已完成或跳过,查看完成百分比并获取下一个推荐主题
  • 运行连通性与缓存/状态诊断检查
适用场景
适合让助手按 roadmap.sh 路径指导开发者学习:探索某条路线图、调取主题笔记、用面试题自测、挑选练习项目,或跟踪已完成的主题。
运行要求
通过 npx 作为本地进程运行,需要 Node.js 20 或更高版本,并需访问 roadmap.sh 与 GitHub 的网络。可选环境变量可设置缓存与状态目录、缓存有效期、HTTP 超时、GitHub 仓库所有者与分支,以及用于提高 GitHub API 速率限制的 GITHUB_TOKEN。
安装前请注意
学习进度保存在本地状态目录;路线图与主题数据从 roadmap.sh 和 GitHub 获取,这些请求会离开本机。GITHUB_TOKEN 为可选项,但属于凭据,仅在接受其用于 GitHub API 调用时设置。进度标记只改动本地状态,不影响任何远端账户。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Roadmapsh,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-roadmapsh

[npm] [Node] [License: MIT]

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)

bash
# 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)

json
{  "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)

bash
git clone https://github.com/aissablk1/mcp-roadmapsh.gitcd mcp-roadmapshnpm install        # `prepare` builds dist/ automaticallynpm test           # end-to-end test against real datanode dist/index.js # stdio MCP servernpm 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)

bash
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

来源:README.md,提交 a41a2d5

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分