jake/mcpengine
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
mcpengine/infra/factory-tools/mcp-validator/ref_stdio_server/README.md
Jake Shore f3c4cd817b Add all MCP servers + factory infra to MCPEngine — 2026-02-06 
=== NEW SERVERS ADDED (7) ===
- servers/closebot — 119 tools, 14 modules, 4,656 lines TS (Stage 7)
- servers/google-console — Google Search Console MCP (Stage 7)
- servers/meta-ads — Meta/Facebook Ads MCP (Stage 8)
- servers/twilio — Twilio communications MCP (Stage 8)
- servers/competitor-research — Competitive intel MCP (Stage 6)
- servers/n8n-apps — n8n workflow MCP apps (Stage 6)
- servers/reonomy — Commercial real estate MCP (Stage 1)

=== FACTORY INFRASTRUCTURE ADDED ===
- infra/factory-tools — mcp-jest, mcp-validator, mcp-add, MCP Inspector
  - 60 test configs, 702 auto-generated test cases
  - All 30 servers score 100/100 protocol compliance
- infra/command-center — Pipeline state, operator playbook, dashboard config
- infra/factory-reviews — Automated eval reports

=== DOCS ADDED ===
- docs/MCP-FACTORY.md — Factory overview
- docs/reports/ — 5 pipeline evaluation reports
- docs/research/ — Browser MCP research

=== RULES ESTABLISHED ===
- CONTRIBUTING.md — All MCP work MUST go in this repo
- README.md — Full inventory of 37 servers + infra docs
- .gitignore — Updated for Python venvs

TOTAL: 37 MCP servers + full factory pipeline in one repo.
This is now the single source of truth for all MCP work.
2026-02-06 06:32:29 -05:00

3.6 KiB
Raw Blame History

Reference MCP STDIO Server

A reference implementation of an MCP (Model Conversation Protocol) server that uses standard input/output (STDIO) as its transport layer. This server implements both the 2024-11-05 and 2025-03-26 protocol versions.

Overview

This server implements the MCP protocol and provides a reference implementation that passes all validation tests for both the 2024-11-05 and 2025-03-26 protocol versions.

Status Update

✅ All tests now pass successfully for both protocol versions!

The server has been validated with the MCP Testing Framework and passes all compliance tests for both protocol versions.

Features

  • Full compliance with MCP protocol specifications:
    • Version 2024-11-05
    • Version 2025-03-26
  • Implements all core protocol methods:
    • initialize/initialized
    • shutdown/exit
    • tools/list and tools/call
    • server/info
  • Tools support with sample implementations:
    • Echo - Simple text echo
    • Add - Basic arithmetic
    • Sleep - Long-running async operation
  • Async tool support:
    • tools/call-async
    • tools/result
    • tools/cancel
  • Proper error handling with JSON-RPC error codes
  • Protocol version validation
  • Comprehensive error handling
  • Batch request support

Usage

Running the server directly

For 2024-11-05 protocol version:

./stdio_server_2024_11_05.py

For 2025-03-26 protocol version:

./stdio_server_2025_03_26.py

Debug mode can be enabled with the MCP_DEBUG environment variable:

MCP_DEBUG=true ./stdio_server_2024_11_05.py
# or
MCP_DEBUG=true ./stdio_server_2025_03_26.py

Testing with the MCP Validator

The server can be tested with the official MCP Testing Framework:

For 2024-11-05:

python -m mcp_testing.scripts.run_stdio_tests --server-command "./ref_stdio_server/stdio_server_2024_11_05.py" --protocol-version 2024-11-05 --debug

For 2025-03-26:

python -m mcp_testing.scripts.run_stdio_tests --server-command "./ref_stdio_server/stdio_server_2025_03_26.py" --protocol-version 2025-03-26 --debug

Generating Full Compliance Reports

For more comprehensive compliance reports, which include specification coverage and detailed results, use the compliance_report.py script. These reports are saved in Markdown format.

For 2024-11-05:

python -m mcp_testing.scripts.compliance_report --server-command "./ref_stdio_server/stdio_server_2024_11_05.py" --protocol-version 2024-11-05 --output-dir "./reports"

For 2025-03-26:

python -m mcp_testing.scripts.compliance_report --server-command "./ref_stdio_server/stdio_server_2025_03_26.py" --protocol-version 2025-03-26 --output-dir "./reports"

Protocol Support Matrix

Feature 2024-11-05 2025-03-26
Core Protocol ✅ ✅
Tools ✅ ✅
Async Tools ❌ ✅
Resources ❌ ✅
Prompt ❌ ❌
Utilities ❌ ❌
Batch Requests ❌ ✅
Streaming ❌ ❌

Implementation Details

  • The server is implemented in Python with no external dependencies
  • Communication is via standard input/output (STDIO)
  • Supports JSON-RPC 2.0 protocol for all communications
  • Error handling follows the JSON-RPC 2.0 specification
  • Async tool support with proper cancellation handling
  • Resource management capabilities

Files

  • stdio_server_2024_11_05.py - Server implementation for protocol version 2024-11-05
  • stdio_server_2025_03_26.py - Server implementation for protocol version 2025-03-26
  • README.md - This documentation file

License

AGPL-3.0-or-later

This server is provided as a reference implementation for educational purposes.