ContextQMD
Back to Dyad

README

testing/README.md

1.3.04.4 KB
Original Source

Fake stdio MCP server

This directory contains a minimal stdio MCP server for local testing.

  • Tools:
    • calculator_add: adds two numbers. Inputs: a (number), b (number).
    • print_envs: returns all environment variables visible to the server as pretty JSON.

Requirements

  • Node 20+ (same as the repo engines)
  • Uses the repo dependency @modelcontextprotocol/sdk and zod

Launch

  • Via Node:

    bash
    node testing/fake-stdio-mcp-server.mjs

  • Via script (adds a stable entrypoint path):

    bash
    testing/run-fake-stdio-mcp-server.sh

Passing environment variables

Environment variables provided when launching (either from your shell or by the app) will be visible to the print_envs tool.

bash
export FOO=bar
export SECRET_TOKEN=example
testing/run-fake-stdio-mcp-server.sh

Integrating with Dyad (stdio MCP)

When adding a stdio MCP server in the app, use:

  • Command: testing/run-fake-stdio-mcp-server.sh (absolute path recommended)
  • Transport: stdio
  • Args: leave empty (not required)
  • Env: optional key/values (e.g., FOO=bar)

Once connected, you should see the two tools listed:

  • calculator_add
  • print_envs

Fake HTTP MCP server

This directory contains a minimal HTTP MCP server for local testing.

  • Tools:
    • calculator_add: adds two numbers. Inputs: a (number), b (number).
    • print_envs: returns all environment variables visible to the server as pretty JSON.

Requirements

  • Node 20+ (same as the repo engines)
  • Uses Node.js built-in http module

Launch

  • Via Node:

    bash
    node testing/fake-http-mcp-server.mjs

  • Via script:

    bash
    testing/run-fake-http-mcp-server.sh

Configuration

  • Port: defaults to 3002, configurable via PORT environment variable
bash
export PORT=3002
node testing/fake-http-mcp-server.mjs

Integrating with Dyad (HTTP MCP)

When adding an HTTP MCP server in the app, use:

  • Name: testing-http-mcp-server (or any name)
  • Transport: http
  • URL: http://localhost:3002/mcp (or your configured port)
  • Headers: Optional. You can add custom headers (e.g., Authorization: Bearer token) if needed for testing.

Once connected, you should see the tools listed:

  • calculator_add
  • print_envs

Fake OAuth-protected MCP server

fake-oauth-mcp-server.mjs bundles a minimal OAuth 2.1 authorization server (discovery, DCR, /authorize, /token, refresh) with a Streamable-HTTP MCP endpoint behind a bearer-token check. Used to test the Dyad MCP OAuth flow against a deterministic target rather than a real provider like Linear.

The /authorize endpoint auto-redirects with a code (no consent UI), so an automated test can drive the full flow without a browser. PKCE S256 is enforced; refresh tokens rotate on use.

Env knobs

VariableDefaultEffect
PORT4002HTTP listen port
FAKE_DCR10 rejects /register (forces use of static client_id)
FAKE_CLIENT_IDnoneRequired when FAKE_DCR=0; the only client_id accepted by /authorize
FAKE_CLIENT_SECRETnoneWhen set, /token requires it in the body
FAKE_REQUIRED_SCOPEnoneWhen set, /authorize 400s if scope missing
FAKE_TOKEN_TTL_SEC3600Access-token lifetime (set low to exercise refresh)

Launch modes

DCR (mimics Linear/Atlassian/Notion):

bash
testing/run-fake-oauth-mcp-server.sh

Static client_id (mimics non-DCR providers — the case real public MCPs generally don't expose):

bash
FAKE_DCR=0 FAKE_CLIENT_ID=my-test-client \
  testing/run-fake-oauth-mcp-server.sh

Wiring into Dyad (manual test)

Add an MCP server in the app with:

  • Transport: http
  • URL: http://localhost:4002/mcp
  • Use OAuth: on
  • OAuth Client ID: leave blank in DCR mode; paste FAKE_CLIENT_ID value in static mode
  • OAuth Scope: read (or leave blank)

Click Connect — the auto-redirect completes silently and the "OAuth: connected" badge should flip on. calculator_add and whoami tools should appear.