Enhanced Server

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