Currents

Currents MCP Server

AI 코딩 에이전트에게 CI 테스트 결과에 대한 완전한 가시성을 제공하세요. Currents MCP Server는 Cursor 및 Claude와 같은 도구를 Currents 대시보드에 직접 연결하여, 에이전트가 편집기를 벗어나지 않고도 불안정한(flaky) 테스트를 진단하고, 실패를 정확히 찾아내며, 실제 실행 데이터를 기반으로 조치를 취할 수 있게 합니다.

• CI에서 실행(run), 스펙 파일, 개별 테스트 결과를 조회합니다
• 테스트 스위트 전반의 오류 추세와 성능 지표를 표시합니다
• 격리 규칙, 웹훅, 프로젝트 설정을 프로그래밍 방식으로 관리합니다
• 에이전트가 추측이 아닌 실제 테스트 출력을 사용하여 문제를 수정하도록 합니다

도구

도구	설명
currents-list-actions	선택적 필터링을 사용하여 프로젝트의 모든 액션을 나열합니다.
currents-create-action	프로젝트에 새 액션을 생성합니다.
currents-get-action	ID로 단일 액션을 가져옵니다.
currents-update-action	기존 액션을 업데이트합니다.
currents-delete-action	액션을 삭제(보관)합니다.
currents-enable-action	비활성화된 액션을 활성화합니다.
currents-disable-action	활성 액션을 비활성화합니다.
currents-list-affected-tests	날짜 범위 내에서 프로젝트의 액션(격리, 건너뛰기, 태그)에 영향을 받는 테스트를 나열합니다.
currents-get-affected-test-executions	날짜 범위 내에서 특정 영향 테스트(서명 기준)의 실행 세부 정보를 가져옵니다.
currents-get-affected-executions	날짜 범위 내에서 특정 액션/규칙이 적용된 테스트 실행을 나열합니다.
currents-get-projects	Currents 플랫폼에서 사용 가능한 프로젝트를 검색합니다.
currents-get-project	ID로 단일 프로젝트를 가져옵니다.
currents-get-project-insights	날짜 범위 내에서 프로젝트의 집계된 실행 및 테스트 메트릭을 가져옵니다.
currents-list-pull-requests	프로젝트의 풀 리퀘스트 카드를 나열합니다(meta.pr.id로 그룹화된 실행).
currents-list-project-terms	한 유형(태그, 브랜치, authorName 등)에 대한 커서 페이지네이션 프로젝트 용어를 나열합니다.
currents-create-jira-issue	조직 Jira 통합을 사용하여 실행 테스트에서 Jira 이슈를 생성합니다.
currents-link-jira-issue	조직 Jira 통합을 사용하여 기존 Jira 이슈를 실행 테스트에 연결합니다.
currents-list-jira-projects	조직 통합에 사용 가능한 Jira 프로젝트를 나열합니다.
currents-list-jira-issue-types	Jira 프로젝트의 Jira 이슈 유형과 사용자 정의 필드를 나열합니다.
currents-get-runs	선택적 필터링을 사용하여 특정 프로젝트의 실행 목록을 검색합니다.
currents-get-run-details	특정 테스트 실행의 세부 정보를 검색합니다.
currents-find-run	쿼리 매개변수로 실행을 찾습니다.
currents-cancel-run	진행 중인 실행을 취소합니다.
currents-reset-run	재실행을 허용하도록 실행에서 실패한 스펙 파일을 재설정합니다.
currents-delete-run	실행 및 모든 관련 데이터를 삭제합니다.
currents-cancel-run-github-ci	GitHub Actions 워크플로 실행 ID와 시도 번호로 실행을 취소합니다.
currents-get-spec-instance	instanceId로 테스트 스펙 파일의 특정 실행에서 디버깅 데이터를 검색합니다.
currents-get-spec-files-performance	날짜 범위 내에서 특정 프로젝트의 스펙 파일 성능 메트릭을 검색합니다.
currents-get-tests-performance	날짜 범위 내에서 특정 프로젝트의 집계된 테스트 메트릭을 검색합니다.
currents-get-tests-signatures	프로젝트, 스펙 파일 경로 및 테스트 제목을 기반으로 고유한 테스트 서명을 생성합니다.
currents-get-test-results	특정 테스트 서명에 대한 과거 테스트 실행 결과를 검색합니다.
currents-get-context	실행, 인스턴스 또는 테스트 수준에서 AI 디버깅을 위한 테스트 실패 컨텍스트를 가져옵니다.
currents-get-errors-explorer	날짜 범위 내에서 프로젝트의 집계된 오류 메트릭을 가져옵니다.
currents-get-test-evidence	CI 실행에서 테스트가 생성한 증거 아티팩트(스크린샷, 비디오, 트레이스, 첨부 파일)를 테스트별로 그룹화된 서명된 다운로드 URL과 함께 수집합니다.
currents-list-webhooks	프로젝트의 모든 웹훅을 나열합니다.
currents-create-webhook	프로젝트에 새 웹훅을 생성합니다.
currents-get-webhook	ID로 단일 웹훅을 가져옵니다.
currents-update-webhook	기존 웹훅을 업데이트합니다.
currents-delete-webhook	웹훅을 삭제합니다.

스킬

AI 에이전트에게 다단계 Currents 워크플로를 가르치는 에이전트 스킬입니다.

스킬	설명
collect-evidence	구현된 작업이 작동함을 보여주거나 데모하기 위해 CI 테스트 아티팩트(전/후 스크린샷, 텍스트 첨부 파일, 비디오, 트레이스)를 사용합니다.

서버는 모든 스킬을 MCP 리소스로 게시하므로, 연결된 에이전트는 로컬 복사본 없이 이를 나열하고 읽을 수 있습니다:

skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md

디스크에서만 스킬을 로드하는 에이전트는 여전히 복사본이 필요합니다 — 스킬 디렉터리를 에이전트의 스킬 위치(예: Claude Code의 경우 .claude/skills/)에 넣으세요.

설정

API 키

여기 지침에 따라 Currents API 키를 받으세요.

Cursor와 함께 사용하기

1. Cursor 설정 > MCP > 활성화로 이동합니다
2. 다음을 mcp.json에 추가합니다.

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Claude Code에 Currents MCP를 추가하려면 이 명령을 실행하세요

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

Claude Desktop에서 Currents MCP를 활성화하려면 다음을 추가하세요(claude_desktop_config.json 파일 편집):

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

원격(호스팅) MCP 엔드포인트

위의 로컬 stdio 전송 외에도, 동일한 서버는 Claude 웹/모바일 앱과 같은 원격 커넥터에서 사용할 수 있도록 호스팅된 Streamable HTTP 엔드포인트(예: https://mcp.currents.dev/mcp)로 실행될 수 있습니다.

호스팅 서버는 자체 인증을 수행하지 않습니다. 각 요청은 Currents API 키를 Bearer 토큰으로 포함해야 하며, 이는 Currents API로 전달됩니다:

Authorization: Bearer <your-currents-api-key>

예시 클라이언트 구성(원격 커넥터):

{
  "mcpServers": {
    "currents": {
      "url": "https://mcp.currents.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

HTTP 서버를 직접 실행하기:

# from the mcp-server package
npm run build && PORT=3000 npm run start:http
# or via Docker (serves /mcp, exposes the configured PORT)
docker build -t currents-mcp . && docker run -p 3000:3000 currents-mcp

Node 서버는 일반 HTTP를 사용합니다. TLS와 공개 도메인은 컨테이너 앞의 리버스 프록시/로드 밸런서에서 종료됩니다. 활성 상태 확인을 위해 GET /healthz 엔드포인트가 제공됩니다.

⚠️ 공지

AI 도구(예: MCP를 통해)를 Currents에 연결함으로써, 귀하는 해당 도구에 API 키, 테스트 결과 및 CI 메타데이터에 대한 접근 권한을 부여하게 됩니다. 사용하는 AI 에이전트나 서비스를 검증하고 데이터를 안전하게 처리하도록 하는 것은 귀하의 책임입니다.

참고 자료

• Currents
• Currents 문서
• 기여 가이드
• 릴리스 및 배포
• 라이선스