
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
概览
本地 MCP 服务器,让助手获取 roadmap.sh 的开发者路线图、最佳实践、面试题、项目创意,并在本地记录学习进度。
- 可以做什么
- 列出并搜索路线图 slug,以 outline 或 raw 形式获取路线图图谱
- 按节点 ID 或关键词读取主题 Markdown 与链接,并把整份路线图导出为 Markdown 或纯文本
- 浏览最佳实践指南、面试题组、练习项目创意和视频资源
- 在本地把主题标记为学习中、已完成或跳过,查看完成百分比并获取下一个推荐主题
- 运行连通性与缓存/状态诊断检查
- 适用场景
- 适合让助手按 roadmap.sh 路径指导开发者学习:探索某条路线图、调取主题笔记、用面试题自测、挑选练习项目,或跟踪已完成的主题。
- 运行要求
- 通过 npx 作为本地进程运行,需要 Node.js 20 或更高版本,并需访问 roadmap.sh 与 GitHub 的网络。可选环境变量可设置缓存与状态目录、缓存有效期、HTTP 超时、GitHub 仓库所有者与分支,以及用于提高 GitHub API 速率限制的 GITHUB_TOKEN。
安装
在 SourceWeft 中
- 打开 控制台中的 Mcp Roadmapsh,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
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
来源:README.md,提交 a41a2d5
工具
0版本历史
1- v0.2.0最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分