Files
czlonkowski--n8n-mcp/tests/integration/mcp-protocol
wehub-resource-sync 409e92d6ae
Build and Push Docker Images / Build Docker Image (push) Has been cancelled
Build and Push Docker Images / Build Railway Docker Image (push) Has been cancelled
Build and Publish n8n Docker Image / test-image (push) Has been cancelled
Dependency Compatibility Check / Fresh Install Dependency Check (push) Has been cancelled
Build and Publish n8n Docker Image / build-and-push (push) Has been cancelled
Build and Publish n8n Docker Image / create-release (push) Has been cancelled
Automated Release / Detect Version Change (push) Has been cancelled
Automated Release / Generate Release Notes (push) Has been cancelled
Automated Release / Create GitHub Release (push) Has been cancelled
Automated Release / Package MCPB Bundle (push) Has been cancelled
Automated Release / Build and Verify (push) Has been cancelled
Automated Release / Publish to NPM (push) Has been cancelled
Automated Release / Build and Push Docker Images (push) Has been cancelled
Automated Release / Update Documentation (push) Has been cancelled
Automated Release / Notify Release Completion (push) Has been cancelled
Secret Scan / secretlint (push) Has been cancelled
Test Suite / test (push) Has been cancelled
Test Suite / cjs-runtime (push) Has been cancelled
Test Suite / publish-results (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:41:06 +08:00
..

MCP Protocol Integration Tests

This directory contains comprehensive integration tests for the Model Context Protocol (MCP) implementation in n8n-mcp.

Test Structure

Core Tests

  • basic-connection.test.ts - Tests basic MCP server functionality and tool execution
  • protocol-compliance.test.ts - Tests JSON-RPC 2.0 compliance and protocol specifications
  • tool-invocation.test.ts - Tests all MCP tool categories and their invocation
  • session-management.test.ts - Tests session lifecycle, multiple sessions, and recovery
  • error-handling.test.ts - Tests error handling, edge cases, and invalid inputs
  • performance.test.ts - Performance benchmarks and stress tests

Helper Files

  • test-helpers.ts - TestableN8NMCPServer wrapper for testing with custom transports

Running Tests

# Run all MCP protocol tests
npm test -- tests/integration/mcp-protocol/

# Run specific test file
npm test -- tests/integration/mcp-protocol/basic-connection.test.ts

# Run with coverage
npm test -- tests/integration/mcp-protocol/ --coverage

Test Coverage

These tests ensure:

  • JSON-RPC 2.0 protocol compliance
  • Proper request/response handling
  • All tool categories are tested
  • Error handling and edge cases
  • Session management and lifecycle
  • Performance and scalability

Known Issues

  1. The InMemoryTransport from MCP SDK has some limitations with connection lifecycle
  2. Tests use the actual database, so they require data/nodes.db to exist
  3. Some tests are currently skipped due to transport issues (being worked on)

Future Improvements

  1. Mock the database for true unit testing
  2. Add WebSocket transport tests
  3. Add authentication/authorization tests
  4. Add rate limiting tests
  5. Add more performance benchmarks