MCP Testing Assistant

Automated testing and coverage reporting for MCP services in the ecosystem.

Overview

The MCP Testing Assistant provides comprehensive testing capabilities for all MCP services, including:

Automated test execution with Jest
Coverage reporting with c8
Test file generation using shared utilities
Mock service creation for testing
Testing infrastructure health checks

Installation

npm install

Usage

MCP Mode (Claude Desktop)

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "testing-assistant": {
      "command": "node",
      "args": ["/path/to/mcp-testing-assistant/start.js"],
      "env": {}
    }
  }
}

HTTP Mode

# Start HTTP bridge on port 9116
npm run http

# Or with custom port
SERVICE_PORT=9200 npm run http

Available Tools

run_tests

Run tests for a specific service or all services.

{
  service: "mcp-secrets-assistant",  // Optional, all services if not specified
  type: "unit",                      // unit, integration, e2e, or all
  coverage: true                     // Generate coverage report
}

generate_tests

Generate test files for a service using shared test utilities.

{
  service: "mcp-logs-assistant",
  tools: ["search_logs", "tail_logs"]  // List of tools to test
}

coverage_report

Generate coverage report for services.

{
  service: "mcp-gateway",  // Optional, all services if not specified
  format: "html"          // text, html, or json
}

test_health

Check testing infrastructure health.

{}  // No parameters required

create_mock

Create a mock service for testing.

{
  service: "mcp-secrets-assistant",
  port: 9300,
  responses: {
    "/health": { status: "healthy", mock: true },
    "/api/tools": { tools: [] }
  }
}

REST API Endpoints

When running in HTTP mode:

GET /health - Service health check
GET /api/tools - List available tools
POST /api/execute - Execute a tool
GET /test-results/:service - Get test results for a service
GET /coverage-summary - Get coverage summary for all services

CLI Commands

# Run coverage report
node index.js coverage [service]

# Generate tests
node index.js generate <service>

# Start in MCP mode
npm start

# Start in HTTP mode
npm run http

Development

# Run in development mode with auto-reload
npm run dev

# Run tests
npm test

Configuration

Environment Variables

SERVICE_PORT - HTTP bridge port (default: 9116)
LOG_LEVEL - Logging level (default: info)
ALLOWED_ORIGINS - CORS allowed origins

Data Storage

Test results and coverage reports are stored in:

~/Documents/mcp-assistant/data/testing/
├── results/      # Test execution results
├── coverage/     # Coverage reports
└── mocks/        # Mock service definitions

Integration with Ecosystem

The Testing Assistant integrates with:

Gateway: Accessible via /api/proxy/testing/*
Launch Assistant: Can be managed as a service
Logs Assistant: Test execution logs are centralized

Best Practices

Regular Testing: Run tests before deploying changes
Coverage Goals: Aim for >80% code coverage
Test Categories: Organize tests by type (unit, integration, e2e)
Mock Services: Use mocks for external dependencies
Continuous Integration: Integrate with CI/CD pipelines

Troubleshooting

Tests Not Found

Ensure test files follow naming convention: *.test.js
Check that services have a tests/ directory

Coverage Not Generated

Verify c8 is installed: npm list c8
Check for .c8rc.json configuration

Mock Service Issues

Ensure port is not in use
Check mock responses are valid JSON

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables automated testing and coverage reporting for MCP services with test execution, file generation, and mock service creation. Provides comprehensive testing infrastructure including Jest integration, coverage reports, and health checks for the MCP ecosystem.

Related MCP Servers

MCP Everything
s2005
-
security
A
license
-
quality
A test server implementing all features of the MCP protocol, including prompts, tools, resources, and sampling, designed for testing MCP clients rather than practical applications.
Last updated -
MIT License
mcp-test-server
kukapay
-
security
F
license
-
quality
A lightweight MCP test server for verifying client connectivity, providing tools, resources, and prompts for integration.
Last updated -
4
Everything MCP Server
infinitum-nihil
-
security
F
license
-
quality
A test MCP server implementing all protocol features including tools, resources, prompts, and sampling to help developers build and test MCP clients.
Last updated -
MCP Server & Client Test Environment
mayur11235
-
security
F
license
-
quality
A testing environment for MCP server setup and client-server interactions, allowing users to verify basic MCP server functionality and test client-server communications including shell command execution.
Last updated -

View all related MCP servers

MCP Testing Assistant