MCP Test Client

MCP テストクライアント

Model Context Protocol（MCP）サーバー向けのテストユーティリティです。このクライアントは、ツール呼び出しと応答の検証を行うシンプルなインターフェースを提供し、MCP サーバーの実装をテストするのに役立ちます。

特長

• MCP サーバー向けの使いやすいテストインターフェース
• ツールの一覧表示と呼び出しを標準でサポート
• TypeScript による型安全な実装
• サーバー応答の検証に使えるアサーションユーティリティ
• サンプル用のモック計算サーバー実装

インストール

bun install mcp-test-client

使用方法

基本的な例

import { MCPTestClient } from 'mcp-test-client';

describe('MCP Server Tests', () => {
  let client: MCPTestClient;

  beforeAll(async () => {
    client = new MCPTestClient({
      serverCommand: 'bun',
      serverArgs: ['./path/to/your/server.ts'],
    });
    await client.init();
  });

  afterAll(async () => {
    await client.cleanup();
  });

  test('should list available tools', async () => {
    const tools = await client.listTools();
    expect(tools).toContainEqual(
      expect.objectContaining({
        name: 'your-tool-name',
        description: 'Your tool description',
      })
    );
  });

  test('should call a tool', async () => {
    await client.assertToolCall(
      'your-tool-name',
      { arg1: 'value1', arg2: 'value2' },
      (result) => {
        expect(result.content[0].text).toBe('expected result');
      }
    );
  });
});

計算サーバーの例

このパッケージには、テストと学習用のモック計算サーバーが含まれています。

import { MCPTestClient } from 'mcp-test-client';

describe('Calculator Server Tests', () => {
  let client: MCPTestClient;

  beforeAll(async () => {
    client = new MCPTestClient({
      serverCommand: 'bun',
      serverArgs: ['./tests/mocks/calculator.ts'],
    });
    await client.init();
  });

  afterAll(async () => {
    await client.cleanup();
  });

  test('should perform addition', async () => {
    await client.assertToolCall(
      'calculate',
      { operation: 'add', a: 5, b: 3 },
      (result) => {
        expect(result.content[0].text).toBe('8');
      }
    );
  });
});

API リファレンス

MCPTestClient

コンストラクター

constructor(config: { serverCommand: string; serverArgs: string[] })

メソッド

• init(): Promise<void> - クライアントを初期化し、サーバーに接続します
• listTools(): Promise<Tool[]> - サーバーで利用できるツールの一覧を取得します
• callTool(toolName: string, args: Record<string, unknown>): Promise<ToolResult> - 指定したツールを呼び出します
• assertToolCall(toolName: string, args: Record<string, unknown>, assertion: (result: ToolResult) => void | Promise<void>): Promise<void> - ツールを呼び出し、結果に対してアサーションを実行します
• cleanup(): Promise<void> - リソースをクリーンアップし、接続を切断します

開発

前提条件

• Bun（v1.0.0 以上）

セットアップ

1. リポジトリをクローンします

git clone <repository-url>
cd mcp-test-client

2. 依存関係をインストールします

bun install

3. テストを実行します

bun test

ライセンス

MIT

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. Pull Request を作成します