Skip to Content
ドキュメント使い方MCP Docs Server

エージェント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 Docs Server はインストール時に インタラクティブなセットアッププロンプトを通じて追加するか、非インタラクティブコマンドで -m フラグを指定して追加できます。

手動インストール

既存のプロジェクトにMCP Docs Serverを追加する場合は、手動でインストールしてください。

  • Cursor: プロジェクトルートの.cursor/mcp.jsonを編集するか、グローバル設定の場合は~/.cursor/mcp.jsonを編集
  • Windsurf: ~/.codeium/windsurf/mcp_config.jsonを編集（グローバル設定のみサポート）
  • VSCode: 作成された.vscodeフォルダをワークスペースのトップレベルに移動するか、作成されたフォルダを新しいワークスペースルートとして開く。プロジェクトルートの~/.vscode/mcp.jsonを編集。 以下の設定を追加：

MacOS/Linux

{
  "mcpServers": {
    "mastra": {
      "command": "npx",
      "args": ["-y", "@mastra/mcp-docs-server"]
    }
  }
}

Windows

{
  "mcpServers": {
    "mastra": {
      "command": "npx",
      "args": ["-y", "@mastra/mcp-docs-server"]
    }
  }
}

設定後

Cursor

自動インストールを実行した場合、Cursorを開くと左下にポップアップが表示され、Mastra Docs MCPサーバーを有効にするよう促されます。

Mastra docs MCPサーバーを有効にするCursorプロンプトを示す図

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

  1. Cursorの設定を開く
  2. MCP設定に移動する
  3. Mastra MCPサーバーの「有効化」をクリックする
  4. エージェントチャットが開いている場合は、MCPサーバーを使用するために再度開くか、新しいチャットを開始する必要があります

Windsurf

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

両方のIDEにおいて、npmからパッケージをダウンロードする必要があるため、初回はMCPサーバーの起動に1分程度かかる場合があります。

VSCode

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

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

MCPはVSCodeのエージェントモードでのみ動作します。エージェントモードに入ったら、mcp.jsonファイルを開いて「開始」ボタンをクリックしてください。「開始」ボタンは、mcp.jsonを含む.vscodeフォルダーがワークスペースのルート、またはエディター内ファイルエクスプローラーの最上位レベルにある場合にのみ表示されます。


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

MCPサーバーを開始した後、Copilotペインのツールボタンをクリックして利用可能なツールを確認してください。


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

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

ドキュメント

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

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

例

コード例を閲覧：

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

ブログ投稿

ブログを検索：

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

パッケージの変更

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

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

よくある問題

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

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

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

    • MCPサーバーやIDEを再起動してください
    • IDEを最新バージョンに更新してください
プロジェクト構造モデルプロバイダー