로컬 핸들러 개발 및 테스트 development

처리기를 로컬로 개발하는 동안 이 참조를 사용하십시오. 처리기 결과 계약에 대해서는 생성된 처리기 사용자 지정을 참조하십시오.

요구 사항

프로젝트 구조

연결된 저장소는 다음 레이아웃을 따릅니다.

your-llm-app/
├── entry.js                   # Webpack entry — do not modify
├── actions/                   # One folder per action
│   └── echo/
│       └── index.js           # Example handler
├── test/
│   ├── actions/
│   │   └── echo.test.js
│   ├── fixtures/
│   │   └── actions.json
│   ├── html-transform.js
│   ├── jest.setup.js
│   └── server.test.js
├── server/
│   └── local.js               # Local dev server (port 9080)
├── actions.json               # Gitignored — optional local metadata
├── app.config.yaml            # Adobe I/O Runtime config
├── webpack.config.js
└── package.json

주요 사항:

로컬 개발

Adobe 자격 증명 없이 로컬에서 핸들러를 개발하고 테스트할 수 있습니다.

npm install
npm run dev:local

이렇게 하면 webpack으로 프로젝트를 빌드하고 http://localhost:9080에서 일반 Node.js HTTP 서버를 시작합니다. 서버가 actions/에서 처리기 파일을 자동 검색하고 MCP 도구로 등록합니다.

로컬 메타데이터 동작

현재 UI에서 actions.json 다운로드를 제공하지 않습니다. 이 파일 없이 로컬 서버를 실행할 수 있습니다. actions/에서 처리기를 검색하여 최소한의 메타데이터로 등록합니다.

actions.json이(가) 없으면 UI 입력 스키마에 대해 로컬 작업 인수의 유효성을 검사하지 않습니다. 단위 및 통합 테스트에서는 대표 메타데이터에 test/fixtures/actions.json을(를) 사용합니다.

curl로 테스트

# List all registered tools
curl -sX POST "http://localhost:9080" \
  -H 'content-type: application/json' \
  -H 'accept: application/json;q=1.0, text/event-stream;q=0.5' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# Call the boilerplate echo action
curl -sX POST "http://localhost:9080" \
  -H 'content-type: application/json' \
  -H 'accept: application/json;q=1.0, text/event-stream;q=0.5' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"echo","arguments":{"message":"hello"}}}'

MCP 검사기를 사용하여 테스트

npx @modelcontextprotocol/inspector

전송 형식​을(를) streamable-http(으)로 설정하고 URL​을(를) http://localhost:9080(으)로 설정합니다.

테스트

처리기 단위 테스트는 test/actions/ 아래에 있으며 actions/ 레이아웃을 미러링합니다.

// test/actions/echo.test.js
const handler = require('../../actions/echo/index.js')

test('echoes the message', async () => {
  const result = await handler({ message: 'hello' })
  expect(result.content[0].text).toBe('Echo: hello')
})

test('always returns content parts', async () => {
  const result = await handler({})
  expect(Array.isArray(result.content)).toBe(true)
})

다음을 사용하여 테스트 실행:

npm test                                      # all tests
npx jest test/actions/echo                   # one action only

로컬 테스트가 통과되면 변경 내용을 푸시하고 변경 내용 배포를 따릅니다.