convez.ai
MCP Server
ReallyArtificial

mcp-jest

ReallyArtificial/mcp-jest

Ver no GitHub
BomPluginScore · de 0 a 100

Automated testing for Model Context Protocol servers. Ship MCP Servers with confidence.

Instalação

$npx convez-ai ReallyArtificial/mcp-jest

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
19
Forks
4
Acompanhando
1
Saúde
87%
Último commit
há 1 mês
Versão
—
Issues abertas
47
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

mcp-jest

Automated testing for Model Context Protocol (MCP) servers. Test your AI agent tools with Jest-like syntax, validate protocol compliance, and integrate with CI/CD.

  • 🧪 Test tools, resources, and prompts — automated validation of your MCP server capabilities
  • 📦 Zero config — works out-of-the-box with any MCP server (stdio, HTTP, SSE)
  • ✅ Protocol validation — check MCP compliance with detailed scoring
  • 🚀 CI/CD ready — GitHub Actions, Jenkins, CircleCI integration
  • 📸 Snapshot testing — capture and compare outputs over time

MIT licensed · npm · GitHub


Install

npm install mcp-jest        # Project dependency
npm install -g mcp-jest     # Or globally for CLI

Use It

Test your MCP server in 30 seconds:

mcp-jest node ./server.js --tools search,email

Or use the JavaScript API:

import { mcpTest } from 'mcp-jest';

const results = await mcpTest(
  { command: 'node', args: ['./server.js'] },
  { tools: ['search', 'email'] }
);

console.log(`${results.passed}/${results.total} tests passed`);

What is MCP?

Model Context Protocol (MCP) is an open standard by Anthropic that lets AI assistants (Claude, ChatGPT, Gemini) connect to external tools, databases, and APIs. MCP-Jest tests those connections.


Why MCP-Jest?

You built an MCP server. But how do you know it works?

  • Manual testing is slow and error-prone
  • Silent failures break AI workflows
  • No native CI/CD integration for MCP
  • Debugging production failures is hard

MCP-Jest solves this with automated, repeatable testing.

Features

Core Testing

  • Automated Testing - Write tests once, run them everywhere
  • Comprehensive Coverage - Test connections, tools, resources, and prompts
  • Flexible Expectations - Simple strings or custom validation functions
  • CI/CD Ready - Works with GitHub Actions, Jenkins, CircleCI, etc.

Advanced Features

  • Snapshot Testing - Capture and compare MCP outputs over time
  • Test Filtering - Run specific tests with --filter and --skip
  • Watch Mode - Auto-rerun tests when files change
  • HTML Reports - Generate beautiful, shareable test reports

Transport Support

  • stdio - Default transport for local servers
  • HTTP Streaming - Test remote HTTP servers
  • SSE - Server-Sent Events support

Developer Tools

  • Auto-Discovery - Automatically discover and generate tests for all capabilities
  • Protocol Validator - Check MCP compliance with detailed scoring
  • GitHub Action - Native CI/CD integration

CLI Quick Reference

CommandDescription
mcp-jest node ./server.js --tools searchTest specific tools
mcp-jest --config test.jsonUse config file
mcp-jest discover node ./server.jsAuto-discover capabilities
mcp-jest validate node ./server.jsCheck protocol compliance
mcp-jest watch node ./server.js --tools searchWatch mode

Common Options

OptionDescription
-t, --tools <tools>Comma-separated tools to test
-c, --config <file>Config file path
--timeout <ms>Test timeout (default: 30000)
-u, --update-snapshotsUpdate snapshot files
--reporter htmlGenerate HTML report

See CLI Reference for all options.

Example: CI/CD Integration

# .github/workflows/test.yml
- name: Test MCP Server
  run: |
    npm install -g mcp-jest
    mcp-jest node ./dist/server.js --tools "search,analyze"

Example: Config File

{
  "server": {
    "command": "node",
    "args": ["./server.js"]
  },
  "tests": {
    "tools": {
      "search": {
        "args": { "query": "test" },
        "expect": "content.length > 0"
      }
    },
    "timeout": 30000
  }
}

Documentation

GuideDescription
Getting StartedStep-by-step setup guide
CLI ReferenceComplete CLI documentation
API ReferenceLibrary API documentation
ExamplesReal-world examples
ArchitectureHow MCP-Jest works
TroubleshootingCommon issues and solutions

Feature Guides

Requirements

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

git clone https://github.com/josharsh/mcp-jest.git
cd mcp-jest
npm install
npm run dev
npm test

Security

See SECURITY.md for our security policy and vulnerability reporting.

Use Cases

MCP-Jest is ideal for:

  • MCP Server Developers - Test your tools, resources, and prompts before deployment
  • AI Application Teams - Ensure your MCP integrations work correctly
  • DevOps/SRE - Add MCP server testing to CI/CD pipelines
  • Open Source MCP Projects - Provide reliable testing for community contributions

Comparison with Other Tools

FeatureMCP-JestManual TestingGeneric Test Frameworks
MCP Protocol SupportNativeManualRequires custom setup
Auto-DiscoveryYesNoNo
Snapshot TestingYesNoVaries
Protocol ValidationYesNoNo
CI/CD IntegrationBuilt-inManualVaries

Support

Related Technologies

License

MIT License - Use freely in commercial and open source projects.


Project Status

npm version npm downloads License: MIT Node.js CI TypeScript PRs Welcome MCP Compatible


Built for the MCP ecosystem | Documentation | Examples | Contributing


Keywords: mcp testing, model context protocol testing, mcp server testing, ai agent testing, llm testing, claude mcp, chatgpt mcp, mcp tools testing, mcp validator, anthropic mcp, test mcp server, mcp ci cd, automated mcp testing

Ver o original no GitHub

Bom para

Relacionados