create-mcp-eval

Generate Jest or Vitest evaluation tests for MCP servers using @mcpjam/sdk.

2.1k|261|Updated May 23, 2025
One-click install
npx skills add https://github.com/MCPJam/inspector --skill create-mcp-eval-mcpjam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-mcp-eval
Source: https://github.com/MCPJam/inspector/tree/main/sdk/skills/create-mcp-eval
Command: npx skills add https://github.com/MCPJam/inspector --skill create-mcp-eval-mcpjam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @mcpjam/sdk, vitest, typescript, jest, ts-jest, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of comprehensive evaluation tests for MCP servers, ensuring tool accuracy and LLM reasoning capabilities are rigorously assessed.

Core Features & Use Cases

  • Automated Test Generation: Creates Jest or Vitest compatible eval tests using the @mcpjam/sdk.
  • LLM-Driven & Deterministic Patterns: Supports both mock-based (deterministic) and LLM-driven test scenarios.
  • Comprehensive Validation: Includes tools for matching tool calls, arguments, and counts, along with multi-turn conversation testing.
  • Use Case: A developer needs to ensure their new MCP server's tools are correctly invoked by an LLM. This Skill generates a test suite that prompts the LLM with various requests and verifies the appropriate tools are called with the right parameters, reporting results directly to MCPJam for analysis.

Quick Start

Generate eval tests for your MCP server using the create-mcp-eval skill.

Frequently Asked Questions about create-mcp-eval

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate evaluation tests for an MCP server?

To generate evaluation tests for an MCP server, use the @mcpjam/sdk to automate test file creation. This produces Jest or Vitest compatible suites that measure tool-selection accuracy, argument correctness, and multi-turn LLM reasoning.

What are LLM-driven and deterministic test patterns for MCP servers?

LLM-driven and deterministic test patterns for MCP servers are evaluation methods that validate tool calls and arguments. Deterministic tests use mocks, while LLM-driven tests prompt the model to verify appropriate tools are called with the correct parameters during multi-turn conversations.

Does the @mcpjam/sdk support both Jest and Vitest frameworks?

Yes, the @mcpjam/sdk supports both Jest and Vitest frameworks for MCP server evaluation. You can generate eval tests compatible with either framework, validating tool-selection accuracy and argument correctness within your existing TypeScript testing environment.

How do I verify if an LLM correctly invokes MCP server tools?

To verify if an LLM correctly invokes MCP server tools, generate an evaluation test suite using the @mcpjam/sdk. The suite prompts the LLM with various requests and validates that appropriate tools are called with the right parameters, reporting results for analysis.

Can I test multi-turn reasoning for my MCP server using TypeScript?

Yes, you can test multi-turn reasoning for your MCP server using TypeScript by generating automated eval tests. The @mcpjam/sdk creates test scenarios that validate multi-turn conversation flows, tool call matching, and argument correctness across Jest or Vitest.