# 먼저 Node.js 설치

npm install -g @example/mcp-server
# ~/.claude/claude_desktop_config.json 파일을 수동으로 편집

# Claude Desktop 재시작

# 제대로 작동하기를 바람

extension.dxt (ZIP 아카이브)
├── manifest.json         # 익스텐션 메타데이터와 설정
├── server/               # MCP 서버 구현
│   └── [서버 파일들]    
├── dependencies/         # 필요한 패키지/라이브러리
└── icon.png             # 선택사항: 익스텐션 아이콘

# 예제: Node.js 익스텐션

extension.dxt
├── manifest.json         # 필수: 익스텐션 메타데이터와 설정
├── server/               # 서버 파일
│   └── index.js          # 메인 진입점
├── node_modules/         # 번들된 의존성
├── package.json          # 선택사항: NPM 패키지 정의
└── icon.png              # 선택사항: 익스텐션 아이콘

# 예제: Python 익스텐션

extension.dxt (ZIP 파일)
├── manifest.json         # 필수: 익스텐션 메타데이터와 설정
├── server/               # 서버 파일
│   ├── main.py           # 메인 진입점
│   └── utils.py          # 추가 모듈
├── lib/                  # 번들된 Python 패키지
├── requirements.txt      # 선택사항: Python 의존성 목록
└── icon.png              # 선택사항: 익스텐션 아이콘

{
  "dxt_version": "0.1",                     // 이 manifest가 따르는 DXT 스펙 버전
  "name": "my-extension",                   // 머신 리더블 이름 (CLI, API에서 사용)
  "version": "1.0.0",                       // 익스텐션의 시맨틱 버전
  "description": "A simple MCP extension",  // 익스텐션 기능에 대한 간단한 설명
  "author": {                               // 저자 정보 (필수)
    "name": "Extension Author"              // 저자 이름 (필수 필드)
  },
  "server": {                               // 서버 설정 (필수)
    "type": "node",                         // 서버 타입: "node", "python", 또는 "binary"
    "entry_point": "server/index.js",       // 메인 서버 파일 경로
    "mcp_config": {                         // MCP 서버 설정
      "command": "node",                    // 서버를 실행할 커맨드
      "args": [                             // 커맨드에 전달할 인자
        "${__dirname}/server/index.js"      // ${__dirname}은 익스텐션 디렉토리로 대체됨
      ]                              
    }
  }
}

{
  "dxt_version": "0.1",
  "name": "my-extension",
  "version": "1.0.0",
  "description": "A simple MCP extension",
  "author": {
    "name": "Extension Author"
  },
  "server": {
    "type": "node",
    "entry_point": "server/index.js",
    "mcp_config": {
      "command": "node",
      "args": ["${__dirname}/server/index.js"],
      "env": {
        "API_KEY": "${user_config.api_key}"
      }
    }
  },
  "user_config": {
    "api_key": {
      "type": "string",
      "title": "API Key",
      "description": "Your API key for authentication",
      "sensitive": true,
      "required": true
    }
  }
}

{
  "dxt_version": "0.1",
  "name": "My MCP Extension",
  "display_name": "My Awesome MCP Extension",
  "version": "1.0.0",
  "description": "A brief description of what this extension does",
  "long_description": "A detailed description that can include multiple paragraphs explaining the extension's functionality, use cases, and features. It supports basic markdown.",
  "author": {
    "name": "Your Name",
    "email": "yourname@example.com",
    "url": "https://your-website.com"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/your-username/my-mcp-extension"
  },
  "homepage": "https://example.com/my-extension",
  "documentation": "https://docs.example.com/my-extension",
  "support": "https://github.com/your-username/my-mcp-extension/issues",
  "icon": "icon.png",
  "screenshots": [
    "assets/screenshots/screenshot1.png",
    "assets/screenshots/screenshot2.png"
  ],
  "server": {
    "type": "node",
    "entry_point": "server/index.js",
    "mcp_config": {
      "command": "node",
      "args": ["${__dirname}/server/index.js"],
      "env": {
        "ALLOWED_DIRECTORIES": "${user_config.allowed_directories}"
      }
    }
  },
  "tools": [
    {
      "name": "search_files",
      "description": "Search for files in a directory"
    }
  ],
  "prompts": [
    {
      "name": "poetry",
      "description": "Have the LLM write poetry",
      "arguments": ["topic"],
      "text": "Write a creative poem about the following topic: ${arguments.topic}"
    }
  ],
  "tools_generated": true,
  "keywords": ["api", "automation", "productivity"],
  "license": "MIT",
  "compatibility": {
    "claude_desktop": ">=1.0.0",
    "platforms": ["darwin", "win32", "linux"],
    "runtimes": {
      "node": ">=16.0.0"
    }
  },
  "user_config": {
    "allowed_directories": {
      "type": "directory",
      "title": "Allowed Directories",
      "description": "Directories the server can access",
      "multiple": true,
      "required": true,
      "default": ["${HOME}/Desktop"]
    },
    "api_key": {
      "type": "string",
      "title": "API Key",
      "description": "Your API key for authentication",
      "sensitive": true,
      "required": false
    },
    "max_file_size": {
      "type": "number",
      "title": "Maximum File Size (MB)",
      "description": "Maximum file size to process",
      "default": 10,
      "min": 1,
      "max": 100
    }
  }
}

npx @anthropic-ai/dxt init

"user_config": {
  "allowed_directories": {
    "type": "directory",
    "title": "Allowed Directories",
    "description": "Directories the server can access",
    "multiple": true,
    "required": true,
    "default": ["${HOME}/Documents"]
  }
}

"server": {
   "type": "node",
   "entry_point": "server/index.js",
   "mcp_config": {
   "command": "node",
   "args": ["${__dirname}/server/index.js"],
   "env": {
      "ALLOWED_DIRECTORIES": "${user_config.allowed_directories}"
   }
   }
}

npx @anthropic-ai/dxt pack

"server": {
  "type": "node",
  "entry_point": "server/index.js",
  "mcp_config": {
    "command": "node",
    "args": ["${__dirname}/server/index.js"],
    "platforms": {
      "win32": {
        "command": "node.exe",
        "env": {
          "TEMP_DIR": "${TEMP}"
        }
      },
      "darwin": {
        "env": {
          "TEMP_DIR": "${TMPDIR}"
        }
      }
    }
  }
}

"tools": [
  {
    "name": "read_file",
    "description": "파일 내용을 읽는다"
  }
],
"prompts": [
  {
    "name": "code_review",
    "description": "코드 리뷰를 통해 모범 사례를 확인한다",
    "arguments": ["file_path"]
  }
]

npm install -g @anthropic-ai/dxt
dxt init
dxt pack

이 확장 기능을 데스크톱 확장(Desktop Extension, 약어 "DXT")으로 구축하고 싶다. 다음 단계를 따라 진행한다:

1. **명세서를 철저히 읽는다:**
   - https://github.com/anthropics/dxt/blob/main/README.md - DXT 아키텍처 개요, 기능, 통합 패턴
   - https://github.com/anthropics/dxt/blob/main/MANIFEST.md - 확장 매니페스트 구조와 필드 정의 전체
   - https://github.com/anthropics/dxt/tree/main/examples - "Hello World" 예제를 포함한 참조 구현

2. **적절한 확장 구조를 만든다:**
   - MANIFEST.md 명세에 따라 유효한 manifest.json 생성
   - @modelcontextprotocol/sdk를 사용해 적절한 도구 정의와 함께 MCP 서버 구현
   - 적절한 오류 처리와 타임아웃 관리 포함

3. **최상의 개발 관행을 따른다:**
   - stdio 전송을 통해 적절한 MCP 프로토콜 통신 구현
   - 명확한 스키마, 검증, 일관된 JSON 응답을 가진 도구 구조화
   - 이 확장이 로컬에서 실행된다는 사실 활용
   - 적절한 로깅과 디버깅 기능 추가
   - 적절한 문서화와 설정 지침 포함

4. **테스트 고려사항:**
   - 모든 도구 호출이 올바르게 구조화된 응답을 반환하는지 검증
   - 매니페스트가 올바르게 로드되고 호스트 통합이 작동하는지 확인

생산 준비가 완료된 코드를 생성해 즉시 테스트할 수 있도록 한다. 방어적 프로그래밍, 명확한 오류 메시지, 정확한 DXT 명세 준수에 초점을 맞춰 생태계와의 호환성을 보장한다.