Skip to Content
ドキュメント使い方CursorやWindsurfでの使用

エージェントIDEのためのMastraツール

@mastra/mcp-docs-serverは、Cursor、Windsurf、Cline、またはMCPをサポートする他のIDEでMastraの完全なナレッジベースに直接アクセスできるようにします。

これはドキュメント、コード例、技術ブログ投稿/機能アナウンス、パッケージの変更履歴にアクセスでき、あなたのIDEがMastraを使って構築するのを助けることができます。

MCPサーバーツールは、エージェントがMastra関連のタスクを完了するために必要な特定の情報を照会できるように設計されています - 例えば：エージェントにMastra機能を追加する、新しいプロジェクトの足場を作る、または何かがどのように機能するかを理解するのを助けるなど。

仕組み

IDEにインストールされると、プロンプトを書いて、エージェントがMastraについてすべてを理解していると想定できます。

機能を追加する

  • 「エージェントに評価を追加してテストを書いてください」
  • 「次のことを行うワークフローを作成してください [タスク]」
  • 「エージェントが [サードパーティAPI] にアクセスできるようにする新しいツールを作成してください」

統合について質問する

  • 「MastraはAI SDKと連携しますか？ [React/Svelte/など] プロジェクトでどのように使用できますか？」
  • 「MCPに関する最新のMastraニュースは何ですか？」
  • 「Mastraは [プロバイダー] の音声APIをサポートしていますか？コードでの使用例を示してください。」

既存のコードをデバッグまたは更新する

  • 「エージェントのメモリに関するバグが発生しています。最近関連する変更やバグ修正はありましたか？」
  • 「Mastraでワーキングメモリはどのように動作し、[タスク] を実行するためにどのように使用できますか？期待通りに動作していないようです。」
  • 「新しいワークフロー機能があると聞きました。それを説明し、[ワークフロー] を更新して使用するようにしてください。」

その他 - 質問がある場合は、IDEに尋ねて調べてもらいましょう。

自動インストール

MCPドキュメントサーバーは、create-mastraコマンドで-mフラグを使用してインストールできます。

npm create mastra@latest --default -m cursor

mcpオプションには以下が含まれます：

  • cursor-global - MCPサーバーをグローバルにインストール
  • windsurf - WindsurfにMCPサーバーをインストール
  • cursor - CursorにMCPサーバーをインストール
  • vscode - VSCodeにMCPサーバーをインストール

または、以下の手順に従ってMCPサーバーを手動でインストールすることもできます。

pnpm create mastra@latestを実行し、プロンプトが表示されたらCursorまたはWindsurfを選択してMCPサーバーをインストールします。他のIDEの場合、またはすでにMastraプロジェクトがある場合は、以下の手順に従ってMCPサーバーをインストールしてください。

手動インストール

  • Cursor: プロジェクトルートの .cursor/mcp.json またはグローバル設定の場合は ~/.cursor/mcp.json を編集してください
  • Windsurf: ~/.codeium/windsurf/mcp_config.json を編集してください（グローバル設定のみ対応）
  • VSCode: プロジェクトルートの ~/.vscode/mcp.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 Serverを有効にするよう促されます。

Mastra docs MCP server を有効にするよう促す cursor のダイアグラム

手動インストールの場合は、以下の手順を行ってください。

  1. Cursor の設定を開く
  2. MCP 設定に移動する
  3. Mastra MCP server の「enable」をクリックする
  4. すでにエージェントチャットを開いている場合は、チャットを再度開くか新しいチャットを開始して MCP server を利用してください

Windsurf

  1. Windsurf を完全に終了し、再度開く
  2. ツール呼び出しが失敗し始めた場合は、Windsurf の MCP 設定に移動し、MCP server を再起動してください。これはよくある Windsurf MCP の問題であり、Mastra とは関係ありません。現時点では Cursor の MCP 実装の方が Windsurf よりも安定しています。

どちらの IDE でも、初回は npm からパッケージをダウンロードする必要があるため、MCP server の起動に少し時間がかかる場合があります。

VSCode

  1. VSCode の設定を開く
  2. MCP 設定に移動する
  3. Chat > MCP オプションの「enable」をクリックする

MCP を有効にするための VSCode の設定ページ

MCP は VSCode ではエージェントモードでのみ動作します。エージェントモードに入ったら、mcp.json ファイルを開き、「start」ボタンをクリックしてください。


MCP を有効にするための VSCode の設定ページ

mcp server を起動した後、copilot ペインのツールボタンをクリックすると利用可能なツールが表示されます。


利用可能なツールを表示する VSCode のツールページ

利用可能なエージェントツール

ドキュメント

Mastraの完全なドキュメントにアクセス：

  • 入門 / インストール
  • ガイドとチュートリアル
  • APIリファレンス

例

コード例を閲覧：

  • 完全なプロジェクト構造
  • 実装パターン
  • ベストプラクティス

ブログ投稿

ブログを検索：

  • 技術的な投稿
  • 変更履歴と機能のお知らせ
  • AIニュースとアップデート

パッケージの変更

Mastraと@mastra/*パッケージの更新を追跡：

  • バグ修正
  • 新機能
  • 破壊的変更

一般的な問題

  1. サーバーが起動しない

    • npxがインストールされ、正常に動作していることを確認する
    • 競合するMCPサーバーがないか確認する
    • 設定ファイルの構文を確認する
    • Windowsの場合、Windows専用の設定を使用していることを確認する

  2. ツール呼び出しが失敗する

    • MCPサーバーやIDEを再起動する
    • IDEを最新バージョンに更新する
プロジェクト構造モデル機能