-
securityA
license-
qualityA 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
Provides automated test execution capabilities using Jest framework, including test running, coverage reporting, and test file generation for MCP services
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 checkGET /api/tools- List available toolsPOST /api/execute- Execute a toolGET /test-results/:service- Get test results for a serviceGET /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.jsCheck that services have a
tests/directory
Coverage Not Generated
Verify c8 is installed:
npm list c8Check for
.c8rc.jsonconfiguration
Mock Service Issues
Ensure port is not in use
Check mock responses are valid JSON
License
MIT
This server cannot be installed
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
- -securityFlicense-qualityA lightweight MCP test server for verifying client connectivity, providing tools, resources, and prompts for integration.Last updated -0
- -securityFlicense-qualityA test MCP server implementing all protocol features including tools, resources, prompts, and sampling to help developers build and test MCP clients.
- -securityFlicense-qualityA 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 -