Ch7. Powers & 커스텀 도구

// Kiro 채팅에서
kiroPowers({ action: "list" })

// 특정 Power 활성화하여 문서와 도구 확인
kiroPowers({ 
  action: "activate", 
  powerName: "weather-power" 
})

// Power의 도구 실행
kiroPowers({
  action: "use",
  powerName: "weather-power", 
  serverName: "weather-api",
  toolName: "get_forecast",
  arguments: {
    location: "Seoul",
    units: "metric"
  }
})

# Documentation Power

API 문서 자동 생성, README 업데이트, 코드 주석 분석 등을 제공합니다.

## 주요 기능
- OpenAPI 스펙 생성
- README 자동 업데이트  
- 코드 주석에서 문서 추출
- 다국어 문서 생성

# Test Automation Power

단위 테스트, 통합 테스트, E2E 테스트 자동 생성 및 실행을 지원합니다.

## 주요 기능
- 테스트 케이스 자동 생성
- 커버리지 분석
- 테스트 결과 리포팅
- CI/CD 통합

# Database Management Power

데이터베이스 스키마 관리, 마이그레이션, 쿼리 최적화를 제공합니다.

## 주요 기능
- 스키마 비교 및 마이그레이션
- 쿼리 성능 분석
- 데이터 백업/복원
- ERD 자동 생성

my-custom-power/
├── POWER.md                 # Power 문서
├── steering/               # 워크플로우 가이드
│   ├── getting-started.md
│   └── advanced-usage.md
├── mcp-servers/           # MCP 서버 구현
│   └── custom-server/
│       ├── server.py
│       └── requirements.txt
└── power.json            # Power 메타데이터

{
  "name": "my-custom-power",
  "displayName": "My Custom Power",
  "version": "1.0.0",
  "description": "커스텀 비즈니스 로직을 위한 Power",
  "keywords": ["custom", "business", "automation"],
  "author": "Your Name",
  "mcpServers": {
    "custom-business": {
      "command": "python",
      "args": ["mcp-servers/custom-server/server.py"],
      "env": {
        "API_KEY": "${CUSTOM_API_KEY}"
      }
    }
  },
  "steeringFiles": [
    "steering/getting-started.md",
    "steering/advanced-usage.md"
  ]
}

# My Custom Power

이 Power는 커스텀 비즈니스 로직을 자동화합니다.

## 설치 및 설정

1. 환경 변수 설정:
   ```bash
   export CUSTOM_API_KEY="your_api_key"

// 데이터 처리
kiroPowers({
  action: "use",
  powerName: "my-custom-power",
  serverName: "custom-business", 
  toolName: "process_data",
  arguments: {
    inputFile: "raw_data.csv",
    outputFormat: "json"
  }
})

### MCP 서버 구현

```python
# mcp-servers/custom-server/server.py
import asyncio
from mcp.server import Server
from mcp.types import Tool, TextContent

app = Server("custom-business")

@app.list_tools()
async def list_tools():
    return [
        Tool(
            name="process_data",
            description="Process raw data into structured format",
            inputSchema={
                "type": "object",
                "properties": {
                    "inputFile": {"type": "string"},
                    "outputFormat": {"type": "string", "enum": ["json", "csv", "xml"]}
                },
                "required": ["inputFile", "outputFormat"]
            }
        ),
        Tool(
            name="generate_report", 
            description="Generate analysis report",
            inputSchema={
                "type": "object",
                "properties": {
                    "dataSource": {"type": "string"},
                    "reportType": {"type": "string", "enum": ["summary", "detailed", "executive"]}
                },
                "required": ["dataSource", "reportType"]
            }
        )
    ]

@app.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "process_data":
        input_file = arguments["inputFile"]
        output_format = arguments["outputFormat"]
        
        # 실제 데이터 처리 로직
        result = f"Processed {input_file} to {output_format} format"
        return TextContent(type="text", text=result)
        
    elif name == "generate_report":
        data_source = arguments["dataSource"]
        report_type = arguments["reportType"]
        
        # 실제 리포트 생성 로직
        report = f"Generated {report_type} report from {data_source}"
        return TextContent(type="text", text=report)

if __name__ == "__main__":
    asyncio.run(app.run())

<!-- steering/getting-started.md -->
---
inclusion: manual
---

# Custom Power 시작하기

이 가이드는 Custom Power를 처음 사용하는 사용자를 위한 단계별 안내입니다.

## 1단계: 데이터 준비

먼저 처리할 데이터 파일을 준비합니다:
- CSV, JSON, XML 형식 지원
- 파일 크기는 100MB 이하 권장

## 2단계: 데이터 처리

`process_data` 도구를 사용하여 데이터를 처리합니다:

```typescript
kiroPowers({
  action: "use",
  powerName: "my-custom-power",
  serverName: "custom-business",
  toolName: "process_data", 
  arguments: {
    inputFile: "your_data.csv",
    outputFormat: "json"
  }
})

kiroPowers({
  action: "use", 
  powerName: "my-custom-power",
  serverName: "custom-business",
  toolName: "generate_report",
  arguments: {
    dataSource: "processed_data.json",
    reportType: "summary"
  }
})

## Power 배포 및 공유

### 로컬 Power 등록

```bash
# Power 디렉토리에서
kiro power register .

# Power를 패키지 파일로 생성
kiro power package my-custom-power
# 결과: my-custom-power-1.0.0.kpower

# 패키지 파일 설치
kiro power install my-custom-power-1.0.0.kpower

# 원격 저장소에서 설치
kiro power install https://github.com/user/my-custom-power

# 각 도구마다 명확한 설명과 예시 제공
## process_data

**설명**: 원시 데이터를 구조화된 형태로 변환합니다.

**입력 매개변수**:
- `inputFile`: 처리할 입력 파일 경로
- `outputFormat`: 출력 형식 (json, csv, xml)

**사용 예시**:
[구체적인 코드 예시]

**주의사항**:
- 파일 크기 제한: 100MB
- 지원 형식: CSV, JSON, XML

@app.call_tool()
async def call_tool(name: str, arguments: dict):
    try:
        if name == "process_data":
            # 입력 검증
            if not os.path.exists(arguments["inputFile"]):
                return TextContent(
                    type="text", 
                    text="Error: Input file not found"
                )
            
            # 실제 처리 로직
            result = process_file(arguments["inputFile"])
            return TextContent(type="text", text=result)
            
    except Exception as e:
        return TextContent(
            type="text",
            text=f"Error: {str(e)}"
        )

{
  "mcpServers": {
    "custom-server": {
      "env": {
        "API_KEY": "${CUSTOM_API_KEY}",
        "DEBUG_MODE": "${DEBUG:-false}",
        "MAX_FILE_SIZE": "${MAX_SIZE:-104857600}"
      }
    }
  }
}