Redash MCP 서버

Claude와 같은 AI 어시스턴트와 Redash를 통합하기 위한 MCP(Model Context Protocol) 서버입니다.

특징

• Redash API를 통해 Redash 인스턴스에 연결
• 사용 가능한 쿼리 및 대시보드를 리소스로 나열합니다.
• 쿼리를 실행하고 결과를 검색합니다.
• 쿼리 생성 및 관리(생성, 업데이트, 보관)
• 쿼리 생성을 위한 데이터 소스 나열
• 대시보드 세부 정보 및 시각화 가져오기

필수 조건

• Node.js(v18 이상)
• npm 또는 yarn
• Redash 인스턴스에 액세스
• Redash API 키

환경 변수

서버에는 다음과 같은 환경 변수가 필요합니다.

• REDASH_URL : Redash 인스턴스 URL(예: https://redash.example.com )
• REDASH_API_KEY : Redash API 키

선택 변수:

• REDASH_TIMEOUT : API 요청에 대한 시간 초과(밀리초) (기본값: 30000)
• REDASH_MAX_RESULTS : 반환할 최대 결과 수(기본값: 1000)

설치

1. 이 저장소를 복제하세요:지엑스피1
2. 종속성 설치:
   npm install
3. Redash 구성으로 .env 파일을 만듭니다.
   REDASH_URL=https://your-redash-instance.com REDASH_API_KEY=your_api_key
4. 프로젝트를 빌드하세요:
   npm run build
5. 서버를 시작합니다:
   npm start

데스크톱용 Claude 사용

Claude for Desktop과 함께 이 MCP 서버를 사용하려면 Claude for Desktop 구성 파일에서 다음과 같이 구성하세요.

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

다음 구성을 추가합니다(필요에 따라 경로를 편집):

사용 가능한 도구

쿼리 관리

• list-queries : Redash에서 사용 가능한 모든 쿼리를 나열합니다.
• get-query : 특정 쿼리의 세부 정보를 가져옵니다
• create-query : Redash에서 새 쿼리를 만듭니다.
• update-query : Redash에서 기존 쿼리를 업데이트합니다.
• archive-query : 쿼리를 보관(소프트 삭제)합니다.
• list-data-sources : 사용 가능한 모든 데이터 소스를 나열합니다.

쿼리 실행

• execute-query : 쿼리를 실행하고 결과를 반환합니다.

대시보드 관리

• list-dashboards : 사용 가능한 모든 대시보드 나열
• get-dashboard : 대시보드 세부 정보 및 시각화 가져오기
• get-visualization : 특정 시각화의 세부 정보를 가져옵니다.

개발

개발 모드에서 실행:

버전 기록

• v1.1.0: 쿼리 관리 기능(생성, 업데이트, 보관)이 추가되었습니다.
• v1.0.0: 최초 릴리스

특허

MIT