Redash MCP 서버

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

특징

• Redash API를 통해 Redash 인스턴스에 연결

• 사용 가능한 쿼리 및 대시보드를 리소스로 나열합니다.

• 쿼리를 실행하고 결과를 검색합니다.

• 쿼리 생성 및 관리(생성, 업데이트, 보관)

• 쿼리 생성을 위한 데이터 소스 나열

• 대시보드 세부 정보 및 시각화 가져오기

Related MCP server: Crunchbase MCP Server

필수 조건

• 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

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

{
  "mcpServers": {
    "redash": {
      "command": "npx",
      "args": [
         "-y",
         "@suthio/redash-mcp"
      ],
      "env": {
        "REDASH_API_KEY": "your-api-key",
        "REDASH_URL": "https://your-redash-instance.com"
      }
    }
  }
}

사용 가능한 도구

쿼리 관리

• list-queries : Redash에서 사용 가능한 모든 쿼리를 나열합니다.

• get-query : 특정 쿼리의 세부 정보를 가져옵니다

• create-query : Redash에서 새 쿼리를 만듭니다.

• update-query : Redash에서 기존 쿼리를 업데이트합니다.

• archive-query : 쿼리를 보관(소프트 삭제)합니다.

• list-data-sources : 사용 가능한 모든 데이터 소스를 나열합니다.

쿼리 실행

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

대시보드 관리

• list-dashboards : 사용 가능한 모든 대시보드 나열

• get-dashboard : 대시보드 세부 정보 및 시각화 가져오기

• get-visualization : 특정 시각화의 세부 정보를 가져옵니다.

개발

개발 모드에서 실행:

npm run dev

버전 기록

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

• v1.0.0: 최초 릴리스

특허

MIT