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 分