mcp-roadmapsh

mcp-roadmapsh

roadmap.sh 用の MCP サーバーです。開発者向けロードマップ、ベストプラクティス、面接の質問、プロジェクトのアイデア、動画、ローカルでの進捗管理を提供します。公式の @modelcontextprotocol/sdk（TypeScript／stdio）を基盤に構築されています。

すべてのデータは公式の公開ソースから取得しています。スクレイピングやモックデータは使用しません。

• https://roadmap.sh/{slug}.json — 描画済みロードマップグラフ
• raw.githubusercontent.com/nilbuild/developer-roadmap — トピックの Markdown
• GitHub contents API — 動的な slug の一覧

前提条件

Node.js 20 以降（node --version で確認できます）。必要なのはこれだけです。npx（Node に同梱）が残りを処理するため、手動でのクローンやビルドは不要です。

クイックスタート

Claude Code（コマンド 1 つ）

# 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

任意の MCP クライアント（JSON 設定）

{
  "mcpServers": {
    "roadmapsh": { "command": "npx", "args": ["-y", "mcp-roadmapsh"] }
  }
}

npm リリース前の最新の GitHub バージョンを実行するには、mcp-roadmapsh を github:aissablk1/mcp-roadmapsh に置き換えてください。

ソースから（コントリビューター向け）

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

ツール

ツール	用途
roadmap_diagnose	接続とキャッシュ／状態のステータス
roadmap_list	すべてのロードマップの slug を一覧表示
roadmap_get	slug でロードマップグラフを取得（outline または raw）
roadmap_topic	トピックの Markdown とリンク（nodeId または query で指定）
roadmap_export	ロードマップ全体を Markdown／テキストとしてエクスポート
roadmap_search	指定範囲内でキーワードに一致する slug を検索
best_practices_list / best_practices_get	ベストプラクティスガイド
questions_list / questions_get	面接質問のグループ
projects_list / project_get	練習用プロジェクトのアイデア
videos_list	動画リソース
progress_mark	トピックの進捗を学習中／完了／スキップとして記録（ローカル）
progress_status	ロードマップの完了率
progress_next	次に学ぶトピックを提案

設定（環境変数）

変数	デフォルト	用途
ROADMAPSH_CACHE_DIR	~/.cache/mcp-roadmapsh	HTTP キャッシュディレクトリ
ROADMAPSH_CACHE_TTL_MS	86400000 (24 h)	キャッシュ TTL
ROADMAPSH_STATE_DIR	~/.local/state/mcp-roadmapsh	進捗状態
ROADMAPSH_TIMEOUT_MS	20000	HTTP タイムアウト
ROADMAPSH_OWNER	nilbuild	developer-roadmap リポジトリの GitHub オーナー
ROADMAPSH_BRANCH	master	developer-roadmap ブランチ
GITHUB_TOKEN	—	任意。GitHub API のレート制限を引き上げます

公開（メンテナー向け）

npm publish                       # to npmjs.com (npm login required first)
npx -y @modelcontextprotocol/publisher publish   # to the official MCP registry (server.json)

このパッケージには mcpName と server.json が含まれており、公式の Model Context Protocol レジストリに掲載できます。

ライセンス

MIT — Aïssa BELKOUSSA