Skip to Content
ドキュメントエージェントツールとMCP

エージェントでツールを使用する

ツールは、エージェントやワークフローによって実行できる型付き関数です。各ツールには、その入力を定義するスキーマ、ロジックを実装する実行関数、およびオプションで設定された統合へのアクセスがあります。

ツールの作成

以下はツールを作成する基本的な例です：

src/mastra/tools/weatherInfo.ts
import { createTool } from "@mastra/core/tools";
import { z } from "zod";
 
export const weatherInfo = createTool({
  id: "Get Weather Information",
  inputSchema: z.object({
    city: z.string(),
  }),
  description: `Fetches the current weather information for a given city`,
  execute: async ({ context: { city } }) => {
    // Tool logic here (e.g., API call)
    console.log("Using tool to fetch weather information for", city);
    return { temperature: 20, conditions: "Sunny" }; // Example return
  },
});

ツールの作成と設計の詳細については、ツールの概要をご覧ください。

エージェントにツールを追加する

ツールをエージェントで利用可能にするには、エージェントの設定の tools プロパティに追加します。

src/mastra/agents/weatherAgent.ts
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";
import { weatherInfo } from "../tools/weatherInfo";
 
export const weatherAgent = new Agent({
  name: "Weather Agent",
  instructions:
    "You are a helpful assistant that provides current weather information. When asked about the weather, use the weather information tool to fetch the data.",
  model: openai("gpt-4o-mini"),
  tools: {
    weatherInfo,
  },
});

エージェントを呼び出すと、設定されたツールを指示内容とユーザーのプロンプトに基づいて使用するかどうかを判断できるようになります。

エージェントにMCPツールを追加する

Model Context Protocol (MCP) は、AIモデルが外部ツールやリソースを発見し、相互作用するための標準化された方法を提供します。Mastraエージェントをサードパーティが提供するツールを使用するためにMCPサーバーに接続することができます。

MCPの概念やMCPクライアントとサーバーの設定方法の詳細については、MCP概要をご覧ください。

インストール

まず、Mastra MCPパッケージをインストールします：

npm install @mastra/mcp@latest

MCPツールの使用

選択肢が多すぎるMCPサーバーレジストリから選ぶのを助けるために、MCP Registry Registry を作成しました。

エージェントで使用したいサーバーが見つかったら、MastraのMCPClientをインポートしてサーバー設定を追加します。

src/mastra/mcp.ts
import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";
 
// Configure MCPClient to connect to your server(s)
export const mcp = new MCPClient({
  servers: {
    filesystem: {
      command: "npx",
      args: [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Downloads",
      ],
    },
  },
});

次に、エージェントをサーバーツールに接続します：

src/mastra/agents/mcpAgent.ts
import { mcp } from "../mcp";
// Create an agent and add tools from the MCP client
const agent = new Agent({
  name: "Agent with MCP Tools",
  instructions: "You can use tools from connected MCP servers.",
  model: openai("gpt-4o-mini"),
  tools: await mcp.getTools(),
});

MCPClientの設定や静的および動的MCPサーバー設定の違いについての詳細は、MCP概要をご覧ください。

MCP リソースへのアクセス

ツールに加えて、MCPサーバーはリソース（アプリケーションで取得・使用できるデータやコンテンツ）も公開できます。

src/mastra/resources.ts
import { mcp } from "./mcp";
 
// Get resources from all connected MCP servers
const resources = await mcp.getResources();
 
// Access resources from a specific server
if (resources.filesystem) {
  const resource = resources.filesystem.find(
    (r) => r.uri === "filesystem://Downloads",
  );
  console.log(`Resource: ${resource?.name}`);
}

各リソースには、URI、名前、説明、MIMEタイプがあります。getResources()メソッドはエラーを適切に処理します - サーバーが失敗したり、リソースをサポートしていない場合、結果から除外されます。

MCPServerを介してAgentをToolとして公開する

MCPサーバーからツールを使用することに加えて、あなたのMastra Agent自体をMastraのMCPServerを使用して任意のMCP互換クライアントにツールとして公開することができます。

AgentインスタンスがMCPServer設定に提供されると：

  • 自動的に呼び出し可能なツールに変換されます。
  • ツールはask_<agentKey>という名前になります。ここで<agentKey>は、MCPServerのagents設定にエージェントを追加する際に使用した識別子です。
  • エージェントのdescriptionプロパティ（空でない文字列である必要があります）がツールの説明を生成するために使用されます。

これにより、他のAIモデルやMCPクライアントが、あなたのMastra Agentを標準的なツールであるかのように、通常は質問を「尋ねる」ことで対話できるようになります。

Agentを含むMCPServer設定の例：

src/mastra/mcp.ts
import { Agent } from "@mastra/core/agent";
import { MCPServer } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
import { weatherInfo } from "../tools/weatherInfo";
import { generalHelper } from "../agents/generalHelper";
 
const server = new MCPServer({
  name: "My Custom Server with Agent-Tool",
  version: "1.0.0",
  tools: {
    weatherInfo,
  },
  agents: { generalHelper }, // 'ask_generalHelper'ツールを公開
});

エージェントがMCPServerによってツールに正常に変換されるためには、そのコンストラクタ設定でdescriptionプロパティが空でない文字列に設定されている必要があります。説明が欠けているか空の場合、MCPServerは初期化中にエラーをスローします。

MCPServerの設定と構成の詳細については、MCPServerリファレンスドキュメントを参照してください。

エージェントメモリ音声の追加