MCP Testing Library

MCP Testing Library

Model Context Protocol（MCP）のテストを実行するための CLI ツールです。

特長

• MCP のテストを実行するための CLI ツール
• 個別のテストファイルやテストパターンを指定して実行できます
• テストのタイムアウトと除外パターンを設定できます
• 詳細な出力を表示する詳細モード
• TypeScript で記述され、型を完全にサポートしています
• Model Context Protocol SDK と互換性があります
• 読みやすいカラフルなテスト出力
• 包括的なテストカバレッジ

インストール

プロジェクトの開発用依存関係としてインストールします。

npm install --save-dev mcp-testing-library

使い方

コマンドラインオプション

Usage: mcpt [options] [test-files...]

Options:
  -v, --version             output version number
  -e, --exclude <patterns>  Exclude files matching the pattern (comma-separated)
                           (default: "**/node_modules/**,**/dist/**")
  -t, --timeout <ms>        Set test timeout in milliseconds (default: "30000")
  --pattern <glob>          Test file pattern to match (default: "**/*.test.{js,ts}")
  --no-color                Disable colored output
  -h, --help                display help for command

例

プロジェクト内のすべてのテストを実行します。

mcpt

特定のテストファイルを実行します。

mcpt sample/index.test.ts

タイムアウトを長くしてテストを実行します。

mcpt --timeout 10000

カラー出力なしでテストを実行します。

mcpt --no-color

特定のディレクトリを除外します。

mcpt --exclude "**/node_modules/**,**/dist/**,**/build/**"

コードでの使用

MCP テストユーティリティは、コードから直接使用することもできます。

import { mcpt, expect } from 'mcp-testing-library';

// Test a filesystem MCP server
mcpt(
  {
    command: 'npx',
    args: ['-y', '@modelcontextprotocol/server-filesystem', '/path/to/directory'],
  },
  async ({ tools, prompts, resources, isMethodExist }) => {
    expect(tools.length).to.be.greaterThan(0);
    expect(await isMethodExist('list-tools')).to.eq(true);

    // More assertions...
  }
);

ライセンス

MIT