Streamable HTTP 마이그레이터

워크플로우중급

엔드포인트, 세션 헤더, Origin 검증, 재연결 정책을 점검해 최신 스펙으로 전환합니다.

트리거/mcp-transport-migrate

사용빈도one-time

Backend Developer라면? Run /mcp-transport-migrate to get a step-by-step migration plan for your SSE endpoints

DevOps Engineer라면? Validate transport compliance after infrastructure changes

Streamable HTTPMCP마이그레이션SSE

작동 흐름

/mcp-transport-migrate [server-dir] run

↓

Phase 1: analyze current transport

endpoint-scan

Map existing HTTP+SSE endpoints

session-headers

Check Mcp-Session-Id handling

origin-check

Validate Origin header verification

reconnect

Audit reconnection behavior

↓

Generate migration diff + rollback plan

↓

✓ Streamable HTTP compliant server + test results

스킬 코드

# Streamable HTTP Migrator Skill
## Trigger: /mcp-transport-migrate [server-directory]

When invoked:

1. Scan current transport implementation:
 - Identify HTTP+SSE endpoint patterns
 - Map event stream connections
 - Check session management approach
 - Document current reconnection logic

2. Generate migration plan:

### Endpoint Changes
| Before (HTTP+SSE) | After (Streamable HTTP) |
|-------------------|------------------------|
| POST /message + GET /sse | POST /mcp (single endpoint) |
| SSE event stream | Response body streaming |
| Custom session cookies | Mcp-Session-Id header |

### Required Code Changes
```typescript
// Before: separate SSE endpoint
app.get('/sse', (req, res) => {
  res.setHeader('Content-Type', 'text/event-stream');
  // ... SSE logic
});

// After: single Streamable HTTP endpoint
app.post('/mcp', (req, res) => {
  const sessionId = req.headers['mcp-session-id'];
  // Validate Origin header
  if (!isValidOrigin(req.headers.origin)) {
    return res.status(403).json({ error: 'Invalid origin' });
  }
  // Stream response using chunked transfer
  res.setHeader('Content-Type', 'application/json');
  // ... handle request with optional streaming
});
```

3. Security checklist:
 - [ ] Origin header validation on all requests
 - [ ] Mcp-Session-Id header generation and validation
 - [ ] DNS rebinding protection
 - [ ] Proper CORS configuration
 - [ ] Session cleanup on DELETE /mcp

4. Output: migration diff + rollback script + test suite

복사해서 CLAUDE.md에 붙여넣으면 바로 사용할 수 있습니다.

Streamable HTTP 마이그레이터 작동 방식

Streamable HTTP Migrator는 기존 HTTP+SSE 엔드포인트를 스캔하여 세션 헤더, Origin 검증, 재연결 로직을 분석한 후, 단일 POST /mcp 엔드포인트 기반의 Streamable HTTP 모델로 전환하는 마이그레이션 diff와 롤백 계획을 생성합니다.