Xk6 MCP

🚀 xk6 - mcp

このプロジェクトは、モデルコンテキストプロトコル (MCP) サーバーをテストするための k6 拡張機能です。

🚀 クイックスタート

このセクションでは、xk6 - mcp 拡張機能を使用して MCP サーバーのテストを始めるための手順を説明します。

📦 インストール

以下の手順に従って、xk6 - mcp 拡張機能をインストールしてください。

1. まず、xk6 がインストールされていることを確認してください。

go install go.k6.io/xk6/cmd/xk6@latest

2. xk6 - mcp 拡張機能を使用して k6 バイナリをビルドします。

xk6 build --with github.com/dgzlopes/xk6-mcp

3. テストスクリプトの先頭で mcp モジュールをインポートします。

import mcp from 'k6/x/mcp';

4. ビルドされたバイナリは現在のディレクトリに生成されます。PATH に移動するか、直接使用することができます。

./k6 run script.js

💻 使用例

基本的な使用法

import mcp from 'k6/x/mcp';

// 使用 stdio 传输初始化 MCP 客户端
const client = new mcp.StdioClient({
  path: 'npx',
  env: [],
  args: ['-y', '@modelcontextprotocol/server-everything', '/tmp'],
});

export default function () {
  console.log('检查 MCP 服务器状态...');
  console.log('MCP 服务器运行中:', client.ping());

  // 列出可用工具
  console.log('可用工具:');
  const tools = client.listTools().tools;
  tools.forEach(tool => console.log(`  - ${tool.name}`));

  // 列出可用资源
  console.log('可用资源:');
  const resources = client.listResources().resources;
  resources.forEach(resource => console.log(`  - ${resource.uri}`));

  // 列出可用提示
  console.log('可用提示:');
  const prompts = client.listPrompts().prompts;
  prompts.forEach(prompt => console.log(`  - ${prompt.name}`));

  // 调用一个示例工具
  const toolResult = client.callTool({
    params: { name: 'echo', arguments: { message: 'Hello, world!' } }
  });
  console.log('Echo 工具响应:', toolResult.content[0].text);

  // 读取一个示例资源
  const resourceContent = client.readResource({
    params: { uri: 'test://static/resource/1' }
  });
  console.log('资源内容:', resourceContent.contents[0].text);

  // 获取一个示例提示
  const prompt = client.getPrompt({
    params: { name: 'simple_prompt' }
  });
  console.log('提示:', prompt.messages[0].content.text);
}

高度な使用法

SSE トランスポートを使用して、これをサポートする MCP サーバーに接続することもできます。

const client = new mcp.SSEClient({
  baseURL: 'http://localhost:3001/sse',
  headers: { Authorization: 'Bearer abc123' },
  timeout: '30s'
});

SSE サーバーを起動するには、以下のコマンドを実行します。

docker run -p 3001:3001 --rm -it tzolov/mcp-everything-server:v1