MCP Enhanced Server v2.0.0

Enhanced MCP (Model Context Protocol) Server with full 2025-03-26 specification support:

Tools - With annotations, outputSchema, structuredContent, resource_link
Resources - URI-identified data with subscriptions and list change notifications
Prompts - Templated messages and workflows with argument schemas
Elicitation - Server-initiated user input requests
Tasks - Async long-running operations with progress tracking
Streamable HTTP - Production-ready HTTP transport with session management
Auth - Bearer token authentication for remote deployments
Origin Validation - DNS rebinding attack prevention

Quick Start

npm install
npm run build
npm start

Transport Modes

Stdio (default)

npm start

Streamable HTTP

MCP_TRANSPORT=http MCP_PORT=3000 npm start

Streamable HTTP with Auth

MCP_TRANSPORT=http MCP_PORT=3000 MCP_AUTH_TOKEN=your-secret-token npm start

Features

Resources

| Resource | URI | Description | |----------|-----|-------------| | Server Info | mcp://server/info | Server name, version, features | | Config Info | mcp://server/config | Transport, auth, environment | | Project Files | file:///{path} | Template-based file access |

Prompts

| Prompt | Description | Arguments | |--------|-------------|-----------| | code_review | Review code quality | code, language | | explain_code | Explain code behavior | code, detail_level | | generate_tests | Generate unit tests | code, framework | | debug_error | Debug code errors | code, error |

Tools

| Tool | readOnly | destructive | idempotent | Description | |------|----------|-------------|------------|-------------| | read_file | ✓ | ✗ | ✓ | Read file contents | | write_file | ✗ | ✓ | ✓ | Write file (overwrites) | | list_directory | ✓ | ✗ | ✓ | List directory contents | | delete_file | ✗ | ✓ | ✗ | Delete a file | | search_code | ✓ | ✗ | ✓ | Regex search in code | | run_command | ✗ | ✓ | ✗ | Execute shell command | | confirm_action | ✓ | ✗ | ✓ | Request user confirmation | | request_input | ✓ | ✗ | ✓ | Request user input | | task_status | ✓ | ✗ | ✓ | Get async task status | | task_cancel | ✗ | ✓ | ✓ | Cancel a running task | | task_list | ✓ | ✗ | ✓ | List all tasks | | batch_process | ✗ | ✗ | ✗ | Start batch processing | | get_weather | ✓ | ✗ | ✓ | Weather data (structured output) | | system_info | ✓ | ✗ | ✓ | System information (structured output) | | list_available_resources | ✓ | ✗ | ✓ | List resources as resource links |

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | MCP_TRANSPORT | stdio | Transport: stdio or http | | MCP_PORT | 3000 | HTTP port | | MCP_HOST | 127.0.0.1 | HTTP host | | MCP_AUTH_TOKEN | - | Bearer token for auth (optional) |

Cloudflare Workers Deployment

Live deployment: https://mcp-enhanced-server.catnip-haze.workers.dev

Health: GET /health
MCP endpoint: POST /mcp (JSON-RPC 2.0)
MCP info: GET /mcp

See cloudflare/ directory for Workers deployment with D1 database.

cd cloudflare
npm install
wrangler d1 create mcp-enhanced-tasks
# Update database_id in wrangler.toml
wrangler d1 execute mcp-enhanced-tasks --file=src/schema.sql
wrangler deploy

Workers Environment Variables

Set via Cloudflare Dashboard or wrangler secret put:

MCP_AUTH_TOKEN - Authentication token
MCP_ALLOWED_ORIGINS - Comma-separated allowed origins

Architecture

src/
├── index.ts              # Main entry, server setup, all features
├── tools/
│   ├── annotations.ts    # Tool Annotation type definitions
│   └── registry.ts       # Tool registry with Zod validation
├── resources/
│   ├── manager.ts        # Resource lifecycle manager
│   └── tools.ts          # Resource tools
├── prompts/
│   ├── manager.ts        # Prompt lifecycle manager
│   └── builtin.ts        # Built-in prompt templates
├── elicitation/
│   ├── manager.ts        # Elicitation request/response manager
│   └── tools.ts          # Elicitation tools
└── tasks/
    ├── manager.ts        # Async task lifecycle manager
    └── tools.ts          # Task tools

Debug

npx @modelcontextprotocol/inspector node dist/index.js

MCP Enhanced Server