@mastra/mcp-docs-serverパッケージは、小さなModel Context Protocol サーバーを実行し、Mastraのドキュメント、コード例、ブログ投稿、変更履歴をLLMエージェントが検索できるようにします。コマンドラインから手動で呼び出すことも、CursorやWindsurfなどのMCP対応IDEで設定することもできます。
CLIから実行する
npx -y @mastra/mcp-docs-server@latest上記のコマンドは、stdioベースのMCPサーバーを実行します。このプロセスはstdinからリクエストを読み取り続け、stdoutにレスポンスを返します。これはIDE統合が使用するのと同じコマンドです。手動で実行する場合は、探索のために@wong2/mcp-cliパッケージを指定することができます。
例
サービング前にドキュメントを再構築する（ローカルでドキュメントを変更した場合に便利）：
REBUILD_DOCS_ON_START=true npx -y @mastra/mcp-docs-server@latest実験中に詳細なログを有効にする：
DEBUG=1 npx -y @mastra/mcp-docs-server@latestカスタムドメインからブログ投稿を提供する：
BLOG_URL=https://my-blog.example npx -y @mastra/mcp-docs-server@latest環境変数
@mastra/mcp-docs-server は、その動作を調整するいくつかの環境変数に対応しています。
REBUILD_DOCS_ON_START-trueに設定すると、サーバーは stdio にバインドする前に.docsディレクトリを再構築します。これは、ローカルでドキュメントを編集または追加した後に役立ちます。PREPARE- ドキュメントのビルドステップ（pnpm mcp-docs-server prepare-docs）は、リポジトリから.docsへ Markdown ソースをコピーするためにPREPARE=trueを探します。BLOG_URL- ブログ記事を取得するために使用されるベースURLです。デフォルトはhttps://mastra.aiです。DEBUGまたはNODE_ENV=development-stderrに書き込まれるログを増やします。
基本的な実行には他の変数は必要ありません。サーバーには事前にビルドされたドキュメントディレクトリが付属しています。
カスタムドキュメントでの再構築
このパッケージには、ドキュメントのプリコンパイルされたコピーが含まれています。追加のコンテンツを試してみたい場合は、.docsディレクトリをローカルで再構築することができます：
pnpm mcp-docs-server prepare-docsこのスクリプトは、mastra/docs/src/content/en/docsとmastra/docs/src/content/en/referenceからドキュメントをコピーしてパッケージに取り込みます。再構築後、REBUILD_DOCS_ON_START=trueを設定してサーバーを起動すると、新しいコンテンツが提供されます。
再構築が必要なのは、カスタマイズされたドキュメントを提供する必要がある場合のみです。通常の使用では、公開されているパッケージの内容に依存することができます。
IDE設定の詳細については、スタートガイドを参照してください。