メインコンテンツへ移動

MCP サーバーの公開

この例では、stdio transport を使用する基本的な Mastra MCPServer をセットアップしてビルドし、NPM への公開準備を行います。

依存関係のインストール
依存関係のインストールへの直接リンク

必要なパッケージをインストールします。

npm install @mastra/mcp @mastra/core tsup

MCP サーバーのセットアップ
MCP サーバーのセットアップへの直接リンク

  1. stdio サーバー用のファイル（例：src/mastra/stdio.ts）を作成します。

  2. 次のコードをファイルに追加します。実際に使用する Mastra Tool を import し、サーバーに適切な名前を付けてください。

    src/mastra/stdio.ts
    #!/usr/bin/env node
    import { MCPServer } from '@mastra/mcp'
    import { weatherTool } from './tools'

    const server = new MCPServer({
      name: 'my-mcp-server',
      version: '1.0.0',
      tools: { weatherTool },
    })

    server.startStdio().catch(error => {
      console.error('Error running MCP server:', error)
      process.exit(1)
    })

  3. package.json を更新し、ビルド済みサーバーファイルを指す bin エントリと、ESM と CJS の両方を出力するビルドスクリプトを追加します。

    package.json
    {
      "bin": "dist/stdio.mjs",
      "scripts": {
        "build:mcp": "tsup src/mastra/stdio.ts --format esm,cjs --no-splitting --dts && echo '#!/usr/bin/env node' | cat - dist/stdio.mjs > temp && mv temp dist/stdio.mjs && chmod +x dist/stdio.mjs"
      }
    }

    このビルドコマンドは、互換性を最大限に高めるため、ESM（.mjs）と CJS（.cjs）の両方を生成します。ESM の成果物には直接実行できるよう shebang（#!/usr/bin/env node）が先頭に追加され、bin エントリはこのファイルを指します。

  4. ビルドコマンドを実行します。

    npm run build:mcp

    サーバーのコードが ESM と CJS の両形式にコンパイルされ、ESM 出力ファイルが実行可能になります。Unix 系システムでは、chmod +x によってファイルを直接実行できるようになります。Windows ユーザーは WSL を使用するか、Node.js から直接実行する必要があります。

NPM への公開
NPM への公開への直接リンク

他のユーザー（または自分）が npx や依存関係として MCP サーバーを利用できるよう、NPM に公開できます。

  1. NPM アカウントを所有し、ログイン済み（npm login）であることを確認します。

  2. package.json のパッケージ名が一意で、利用可能であることを確認します。

  3. ビルド後、プロジェクトルートから公開コマンドを実行します。

    npm publish --access public

    パッケージの公開について詳しくは、NPM ドキュメントを参照してください。

公開した MCP サーバーの使用
公開した MCP サーバーの使用への直接リンク

公開後は、パッケージを実行するコマンドを指定することで、MCPClient から MCP サーバーを使用できます。Claude Desktop、Cursor、Windsurf など、ほかの MCP クライアントも利用できます。

import { MCPClient } from '@mastra/mcp'

const mcp = new MCPClient({
  servers: {
    // Give this MCP server instance a name
    yourServerName: {
      command: 'npx',
      args: ['-y', '@your-org-name/your-package-name@latest'], // Replace with your package name
    },
  },
})

// You can then get tools or toolsets from this configuration to use in your agent
const tools = await mcp.listTools()
const toolsets = await mcp.listToolsets()

注：組織スコープを付けずに公開した場合、args は ["-y", "your-package-name@latest"] になることがあります。

On this page