Mastra Tools for your agentic IDE
@mastra/mcp-docs-server
は、Cursor、Windsurf、Cline、またはMCPをサポートする他の任意のIDEで、Mastraの完全な知識ベースに直接アクセスを提供します。
これには、ドキュメント、コード例、技術ブログ投稿/機能発表、およびパッケージの変更履歴へのアクセスが含まれており、あなたのIDEがMastraを使用して構築するのを助けるために読むことができます。
MCPサーバーツールは、エージェントがMastra関連のタスクを完了するために必要な特定の情報をクエリできるように設計されています。例えば、エージェントにMastra機能を追加する、新しいプロジェクトをスキャフォルドする、または何かの動作を理解するのを助けるなどです。
仕組み
IDEにインストールされると、プロンプトを書いて、エージェントがMastraについてすべて理解していると仮定できます。
機能を追加
- “エージェントに評価を追加してテストを書く”
- “次の
[task]
を行うワークフローを書いてください” - “エージェントが
[3rd party API]
にアクセスできる新しいツールを作成してください”
統合について質問する
- “MastraはAI SDKと連携しますか?
どのようにして
[React/Svelte/etc]
プロジェクトで使用できますか?” - “MCPに関する最新のMastraニュースは何ですか?”
- “Mastraは
[provider]
の音声およびボイスAPIをサポートしていますか?コード内での使用例を見せてください。“
既存のコードをデバッグまたは更新する
- “エージェントのメモリにバグが発生しています。最近関連する変更やバグ修正がありましたか?”
- “Mastraでの作業メモリはどのように動作し、
[task]
を行うためにどのように使用できますか?期待通りに動作しないようです。” - “新しいワークフロー機能があると聞きました。それを説明してから、
[workflow]
をそれらを使用するように更新してください。”
さらに多く - 質問があれば、IDEに尋ねて調べてもらいましょう。
自動インストール
pnpm create mastra@latest
を実行し、プロンプトが表示されたらCursorまたはWindsurfを選択してMCPサーバーをインストールします。他のIDEの場合、またはすでにMastraプロジェクトがある場合は、以下の手順に従ってMCPサーバーをインストールしてください。
手動インストール
- Cursor: プロジェクトのルートにある
.cursor/mcp.json
を編集するか、グローバル設定の場合は~/.cursor/mcp.json
を編集します - Windsurf:
~/.codeium/windsurf/mcp_config.json
を編集します(グローバル設定のみサポート)
次の設定を追加します:
MacOS/Linux
{
"mcpServers": {
"mastra": {
"command": "npx",
"args": ["-y", "@mastra/mcp-docs-server@latest"]
}
}
}
Windows
{
"mcpServers": {
"mastra": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@mastra/mcp-docs-server@latest"]
}
}
}
設定後
Cursor
自動インストールに従った場合、Cursorを開くと左下隅にポップアップが表示され、Mastra Docs MCPサーバーを有効にするよう促されます。

それ以外の場合、手動インストールでは、以下の手順に従ってください。
- Cursorの設定を開く
- MCP設定に移動する
- Mastra MCPサーバーの「有効化」をクリックする
- エージェントチャットが開いている場合は、MCPサーバーを使用するために再度開くか、新しいチャットを開始する必要があります
Windsurf
- Windsurfを完全に終了して再起動する
- ツール呼び出しが失敗し始めた場合は、WindsurfのMCP設定に移動し、MCPサーバーを再起動してください。これはWindsurfのMCPに関する一般的な問題であり、Mastraとは関係ありません。現在、CursorのMCP実装はWindsurfのものよりも安定しています。
両方のIDEで、MCPサーバーが最初に起動するまでに1分ほどかかる場合があります。これはnpmからパッケージをダウンロードする必要があるためです。
利用可能なエージェントツール
ドキュメント
Mastraの完全なドキュメントにアクセス:
- 始め方 / インストール
- ガイドとチュートリアル
- APIリファレンス
例
コード例を閲覧:
- 完全なプロジェクト構造
- 実装パターン
- ベストプラクティス
ブログ投稿
ブログを検索:
- 技術的な投稿
- 変更履歴と機能発表
- AIニュースと更新
パッケージの変更
Mastraと@mastra/*
パッケージの更新を追跡:
- バグ修正
- 新機能
- 互換性を壊す変更
一般的な問題
-
サーバーが起動しない
- npxがインストールされ、正常に動作していることを確認する
- 競合するMCPサーバーがないか確認する
- 設定ファイルの構文を確認する
- Windowsの場合、Windows専用の設定を使用していることを確認する
-
ツール呼び出しが失敗する
- MCPサーバーやIDEを再起動する
- IDEを最新バージョンに更新する