McpMocker

Defined in: mcp.ts:297

MCP mocking utilities class.

Provides methods for mocking MCP servers, tools, and resources during testing.

Example

import { McpMocker } from 'vitest-agentic-control';

const mocker = new McpMocker();

// Create a mock MCP server
const server = mocker.mockServer('test-server', {
  tools: [
    {
      name: 'get_weather',
      description: 'Get weather for a location',
      handler: (args) => ({ temp: 72, condition: 'sunny' }),
    },
  ],
  resources: [
    {
      uri: 'file:///config.json',
      content: '{"key": "value"}',
    },
  ],
});

// Use the mock server in tests
await server.connect();
const result = await server.callTool('get_weather', { location: 'NYC' });

Constructors

Constructor

new McpMocker(options?): McpMocker

Defined in: mcp.ts:304

Parameters

options?

McpMockerOptions = {}

Returns

McpMocker

Properties

servers

readonly servers: Map<string, MockMcpServer>

Defined in: mcp.ts:299

Map of mock servers by name

Methods

createMockResource()

createMockResource(uri, content, options?): MockResourceDefinition

Defined in: mcp.ts:424

Create a mock resource that can be registered with servers.

Parameters

uri

string

Resource URI

content

Resource content

string | Buffer<ArrayBufferLike>

options?

Additional options

description?

string

mimeType?

string

name?

string

Returns

MockResourceDefinition

Resource definition

---

createMockTool()

createMockTool(name, handler, options?): MockToolDefinition

Defined in: mcp.ts:400

Create a mock tool that can be registered with servers.

Parameters

name

string

Tool name

handler

(args) => unknown

Tool handler

options?

Additional options

description?

string

inputSchema?

Record<string, unknown>

Returns

MockToolDefinition

Tool definition

---

getServer()

getServer(name): MockMcpServer | undefined

Defined in: mcp.ts:329

Get a mock server by name.

Parameters

name

string

Server name

Returns

MockMcpServer | undefined

The mock server or undefined

---

mockAllModules()

mockAllModules(): Record<string, unknown>

Defined in: mcp.ts:360

Mock all MCP-related modules.

Returns

Record<string, unknown>

Dictionary of mocked modules

---

mockClient()

mockClient(): Mock

Defined in: mcp.ts:338

Mock the MCP client module.

Returns

Mock

Mock client factory

---

mockServer()

mockServer(name, config?): MockMcpServer

Defined in: mcp.ts:317

Create a mock MCP server.

Parameters

name

string

Server name

config?

Omit<MockMcpServerConfig, "name"> = {}

Server configuration

Returns

MockMcpServer

The mock server

---

resetAll()

resetAll(): void

Defined in: mcp.ts:453

Reset all mock servers.

Returns

void

---

restoreAll()

restoreAll(): void

Defined in: mcp.ts:445

Restore all mocked modules.

Returns

void