MCP Test Kits - TypeScript

Build from source using the official MCP SDK.

Build

cd typescript
npm install
npm run build

stdio

{
  "mcpServers": {
    "mcp-test-kits": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-test-kits/typescript",
      "transport": "stdio"
    }
  }
}

HTTP

Start server:

node dist/index.js --transport http --port 3000

MCP client config:

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

With OAuth

Start server:

node dist/index.js --transport http --port 3000 --enable-oauth
# or auto-approve for testing
node dist/index.js --transport http --port 3000 --enable-oauth --oauth-auto-approve

MCP client config (OAuth discovery automatic):

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

Or with pre-obtained token:

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

SSE

Start server:

node dist/index.js --transport sse --port 3000

MCP client config:

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/sse",
      "transport": "sse"
    }
  }
}

With OAuth

Start server:

node dist/index.js --transport sse --port 3000 --enable-oauth
# or auto-approve for testing
node dist/index.js --transport sse --port 3000 --enable-oauth --oauth-auto-approve

MCP client config (OAuth discovery automatic):

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/sse",
      "transport": "sse"
    }
  }
}

Or with pre-obtained token:

{
  "mcpServers": {
    "mcp-test-kits": {
      "url": "http://localhost:3000/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

Test with MCP Inspector

# stdio
npx @modelcontextprotocol/inspector node dist/index.js

# HTTP (start server first: node dist/index.js --transport http --port 3000)
npx @modelcontextprotocol/inspector --transport http --server-url http://localhost:3000/mcp

# SSE (start server first: node dist/index.js --transport sse --port 3000)
npx @modelcontextprotocol/inspector --transport sse --server-url http://localhost:3000/sse

Development

npm run dev        # Run with tsx
npm run build      # Build to dist/
npm run typecheck  # Type check
npm run lint       # Lint code
npm test           # Run tests