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

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

  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 サーバーを起動するのに少し時間がかかる場合があります。

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

ドキュメント

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

  • 始め方 / インストール
  • ガイドとチュートリアル
  • APIリファレンス

例

コード例を閲覧:

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

ブログ投稿

ブログを検索:

  • 技術的な投稿
  • 変更履歴と機能発表
  • AIニュースと更新

パッケージの変更

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

  • バグ修正
  • 新機能
  • 互換性を壊す変更

一般的な問題

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

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

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

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