app/
  api/mcp/route.ts          MCP 엔드포인트 (GET/POST/DELETE)
  layout.tsx, page.tsx      서버 정보를 보여주는 안내 페이지
src/mcp/
  register.ts               도구·리소스·프롬프트 등록 진입점
  server-info.ts            서버 이름/버전, 커스텀 헤더 이름
  helpers.ts                공용 헬퍼 (fetch, 결과 포맷, 에러 변환 등)
  hf-token.ts               요청 헤더 → 환경변수 순으로 HF 토큰 결정
  tools/                    도구 5종
  resources/                리소스
  prompts/                  프롬프트

npm install
npm run dev     # http://localhost:3000/api/mcp

npm run build
npm run start

{
    "mcpServers": {
        "MG6_Server": {
            "url": "http://localhost:3000/api/mcp",
            "headers": {
                "x-hf-token": "hf_your_token_here"
            }
        }
    }
}

{
    "mcpServers": {
        "MG6_Server": {
            "command": "npx",
            "args": ["-y", "mcp-remote", "http://localhost:3000/api/mcp"]
        }
    }
}

npm run inspector

import type { McpServer } from '@modelcontextprotocol/server'
import { z } from 'zod'

import { textOutputSchema, textResult } from '../helpers'

export function registerEcho(server: McpServer) {
    server.registerTool(
        'echo',
        {
            title: '에코',
            description: '입력을 그대로 돌려줍니다.',
            inputSchema: z.object({ message: z.string() }),
            outputSchema: textOutputSchema('에코 결과')
        },
        async ({ message }) => textResult(message)
    )
}