wowaudit-mcp-server

문서화된 WoWAudit API를 위한 MCP 서버입니다. 길드 명단, 공격대 일정, 출석, 주간 활동, 위시리스트, 전리품 기록, 지원서를 Raid Lens 및 기타 MCP 클라이언트를 위한 구조화된 도구로 제공합니다.

이 서버는 stdio와 @modelcontextprotocol/server 2.x를 사용합니다. 현재 MCP 프로토콜을 제공하며, SDK의 레거시 2025년형 초기화 핸드셰이크를 이전 클라이언트를 위해 유지합니다. 모든 결과에는 기본 structuredContent와 동일한 JSON이 텍스트 블록으로 포함되어 있어 구조화된 결과를 사용하지 않는 클라이언트도 사용할 수 있습니다.

요구 사항

• Node.js 20 이상.

• WoWAudit 팀 API 키. 팀 관리자는 팀의 설정 > 팀 > API 키 필드에서 복사하거나 https://wowaudit.com/api에서 팀을 선택하여 가져올 수 있습니다. WoWAudit은 현재 범위가 지정된 읽기 전용 공개 API 키를 제공하지 않습니다. 이 서버는 기본적으로 로컬에서 읽기 전용 액세스를 강제합니다.

Related MCP server: wow-mcp

설정

npm install

.env.example에서 .env를 만든 후 다음을 설정하세요:

WOWAUDIT_API_KEY=your-team-api-key

서버를 빌드하세요:

npm run build

API 키는 지연 로드되므로 MCP 프로세스가 키 없이 시작되어 도구를 나열할 수 있습니다. 키를 사용할 수 있을 때까지 API 호출은 구조화된 구성 오류를 반환합니다.

MCP 클라이언트 구성

MCP 클라이언트에서 컴파일된 진입점을 사용하세요:

{
  "mcpServers": {
    "wowaudit": {
      "command": "node",
      "args": [
        "C:\\programming\\typescript\\wowaudit-mcp-server\\dist\\index.js"
      ]
    }
  }
}

서버는 MCP 클라이언트의 작업 디렉터리가 아닌 설치된 위치를 기준으로 .env를 확인합니다. 자격 증명은 대신 클라이언트의 env 구성을 통해 제공될 수 있습니다.

보안 모델

WoWAudit 팀 API 키는 팀의 전체 환경에 접근할 수 있습니다. 서버는 다음과 같은 보호 조치를 적용합니다:

• 키는 Authorization: Bearer 헤더로만 전송됩니다. URL, 결과 또는 오류에 절대 포함되지 않습니다.

• 문서화된 /v1/ 경로만 사용할 수 있습니다. 임의 HTTP 도구는 없습니다.

• WOWAUDIT_ENABLE_WRITES=true가 아니면 쓰기 도구는 광고되거나 호출할 수 없습니다. HTTP 클라이언트는 비활성화된 동안 변경 요청을 독립적으로 차단합니다.

• 파괴적인 삭제 도구는 각 호출에 대해 confirm: true를 추가로 필요로 합니다.

• 지원서 도구는 WOWAUDIT_ENABLE_APPLICATIONS=true가 아니면 비활성화됩니다. 지원서에는 신원, 설문지 답변, 업로드된 파일 URL이 포함될 수 있기 때문입니다.

• 도구 주석은 최신 MCP 클라이언트에 읽기 전용, 멱등성, 파괴적 작업을 식별합니다.

• 응답은 기본적으로 2MiB로 제한됩니다. 필요한 경우에만 WOWAUDIT_MAX_RESPONSE_BYTES를 조정하세요.

• GET 응답은 프로세스 내에서 30초 동안 캐시됩니다. 성공적인 쓰기는 캐시를 지웁니다.

지원서 도구를 활성화해도 채널 권한이 부여되지는 않습니다. Discord 통합은 해당 도구를 노출하기 전에 관리자 전용 액세스를 적용해야 합니다. 마찬가지로, 다중 길드 봇은 신뢰할 수 있는 Discord 길드 ID를 모델이 제어하는 도구 인수 외부에서 올바른 WoWAudit 자격 증명에 바인딩해야 합니다.

구성

기본 구성은 11개의 민감하지 않은 GET 도구를 노출합니다. WOWAUDIT_ENABLE_APPLICATIONS=true를 설정하면 두 개의 읽기 전용 지원서 도구가 추가됩니다. WOWAUDIT_ENABLE_WRITES=true를 설정하면 변경 도구가 추가됩니다. 엄격히 읽기 전용 MCP 표면을 위해 설정하지 않은 상태로 두세요.

도구

아래에 표시된 변경 도구는 WOWAUDIT_ENABLE_WRITES=true일 때만 등록됩니다. 지원서 도구는 WOWAUDIT_ENABLE_APPLICATIONS=true일 때만 등록됩니다.

팀 및 명단

활동 및 출석

공격대 및 신청

wowaudit_update_raid는 상태 및 일정 변경, 우두머리 활성/비활성화 목록, 신청 상태, 댓글, 역할/직업 재정의, 선택 상태, 우두머리별 선택을 지원합니다.

위시리스트 및 전리품

모든 캐릭터 위시리스트 및 전리품 엔드포인트는 클 수 있습니다. 캐릭터별 호출을 선호하고 가능하면 컬렉션 도구에 limit을 사용하세요.

지원서

지원서는 WOWAUDIT_ENABLE_APPLICATIONS=true로 별도로 제어됩니다. 변경하려면 WOWAUDIT_ENABLE_WRITES=true도 필요합니다.

결과 봉투

성공적인 도구는 다음을 반환합니다:

{
  "data": {},
  "meta": {
    "endpoint": "/v1/team",
    "method": "GET"
  }
}

limit을 허용하는 컬렉션 도구는 추가로 totalItems, returnedItems, truncated를 보고합니다. 공개 API가 서버 측 페이지 매김을 문서화하지 않기 때문에 WoWAudit이 응답한 후 제한이 적용됩니다.

오류는 isError: true, 구조화된 { "error": "..." }, 텍스트 대체를 반환합니다. 업스트림 오류는 가능한 경우 kind, HTTP status, retryAfterSeconds도 포함합니다.

개발

npm run dev
npm test

테스트는 서버를 컴파일하고, 현대 및 레거시 프로토콜 협상을 모두 확인하고, 모든 도구 스키마와 주석을 검사하고, 보안 게이트를 실행하고, 실제 API 키 없이 HTTP 클라이언트를 테스트합니다.

작은 라이브 읽기 전용 확인을 위해:

npm run test:live

라이브 스모크 테스트는 팀, 기간, 명단, 공격대 목록 엔드포인트를 호출합니다. 지원서 또는 쓰기 도구는 절대 호출하지 않습니다.

WoWAudit API 주의 사항

• 공개 문서는 페이지 매김이나 속도 제한 계약을 정의하지 않습니다.

• 문서는 주로 엄격한 재사용 가능 스키마보다는 응답 예제를 제공하므로 페이로드 필드는 변경될 수 있습니다.

• 포함된 문서에는 개발용으로 보이는 서버 URL이 있습니다. 이 프로젝트는 기본적으로 확인된 프로덕션 원본 https://api.wowaudit.com을 사용합니다.

• WoWAudit은 쿼리 매개변수에 API 키를 허용하지만, 이 서버는 자격 증명 누출을 줄이기 위해 의도적으로 인증 헤더만 사용합니다.

라이선스

MIT, 저작권 WoWAudit MCP Server 기여자.