be-user-chat-mcp

개요

be-user-chat-mcp는 Channel.io 백엔드 시스템의 다양한 컨텍스트 정보를 조회하기 위한 Model Context Protocol (MCP) 서버입니다. AI 코딩 어시스턴트가 이 서버를 통해 필요한 백엔드 데이터 컨텍스트를 얻어 다양한 개발 작업을 효율적으로 지원할 수 있도록 설계되었습니다. 특정 도메인에 국한되지 않고, 새로운 데이터 소스 및 조회 로직을 쉽게 추가할 수 있는 확장성을 목표로 합니다.

사용 방법

1. be-user-chat-mcp 빌드

   cd apps/be-user-chat-mcp && pnpm install && pnpm build

2. Cursor MCP 서버 추가

   Cursor Settings > Features > MCP 에서 "+ Add New MCP Server"를 클릭하여 MCP 서버를 추가합니다. (참고 문서)

   • Name: be-user-chat-mcp (또는 원하는 이름)

   • Type: command

   • Command: npx

   • Args: (아래 두 줄을 각각 추가)

     • -y
     • @channel.io/be-user-chat-mcp

   • Env: (필요한 환경 변수를 Key-Value 형태로 추가)

     • REDASH_URL: <<Redash URL>>

     • REDASH_API_KEY: <<Redash API 키>>

     • SENTRY_AUTH_TOKEN: <<Sentry Auth 토큰 (event:read, org:read, project:read 필요)>>

     • AWS_PROFILE: <<aws sso config를 통해 설정한 AWS PROFILE 이름>>

     • (다른 필요한 환경 변수 추가)

     • npx를 사용하면 별도의 전역 설치 없이 패키지를 실행할 수 있습니다.

     • <<ch-mcp-tools 루트 경로>>: 로컬 머신에 클론된 ch-mcp-tools 저장소의 전체 경로를 정확히 입력합니다. (예: /Users/username/Documents/Development/ch-mcp-tools)

     • 환경 변수 및 AWS 자격 증명:

       • Env 섹션에는 서버가 백엔드 데이터 소스(Redash, AWS DynamoDB 등)에 접근하는 데 필요한 환경 변수를 설정합니다. 실제 값(키, 토큰 등)은 보안에 유의하여 관리하세요.
       • 이 서버는 AWS SDK의 기본 자격 증명 제공자 체인(Default Credential Provider Chain)을 사용합니다. 따라서 AWS 자격 증명의 경우, 위 Env 섹션에 명시적으로 설정하는 대신 터미널에서 aws sso login 명령 (필요시 --profile {프로필 이름} 또는 --sso-session {세션 이름} 옵션 포함)을 실행하여 유효한 SSO 세션을 시작하는 것만으로도 서버가 자격 증명을 자동으로 인식하여 인증할 수 있습니다.
       • 시스템 환경 변수나 .env 파일 등으로 이미 설정된 변수는 여기서 다시 설정할 필요가 없을 수 있습니다.

3. AI 어시스턴트와 상호작용

   채팅 인터페이스에서 AI 어시스턴트에게 조회하려는 데이터에 필요한 식별자(예: 특정 엔티티 ID)를 제공하여 관련 데이터를 요청합니다.

   예시 프롬프트:

   특정 ID 'xxxxxxxx'와 관련된 데이터를 조회해줘.

   AI 어시스턴트는 등록된 MCP 서버(be-user-chat-mcp) 내의 적절한 함수(예: mcp_be-user-chat-mcp_get_entity_data)를 호출하여 요청된 정보를 가져와 응답에 활용합니다. 사용 가능한 함수와 필요한 파라미터는 서버 구현 내용을 참고하세요.

   ⚠️ 주의사항: 이 MCP 서버는 AI 어시스턴트에게 필요한 컨텍스트를 제공하기 위한 목적으로 설계되었습니다. AI 어시스턴트가 이 서버를 통해 직접 데이터베이스 쿼리나 Redash 쿼리 등을 실행하도록 요청해서는 안 됩니다. 서버는 미리 정의된 로직에 따라 식별자를 기반으로 관련 데이터를 가져오는 역할만 수행해야 합니다.

주요 기능 및 특징

• 다양한 백엔드 데이터 소스(예: 데이터베이스, 내부 API, 캐시 등)로부터 컨텍스트 정보 조회
• 요청된 식별자를 기반으로 관련 데이터 엔티티들을 검색하고 조합하여 제공
• 필요에 따라 데이터를 가공하여 AI 어시스턴트가 이해하고 활용하기 용이한 형태로 변환
• 새로운 데이터 조회 로직 및 엔드포인트를 쉽게 추가하고 확장할 수 있는 유연한 구조

이 서버를 통해 AI 어시스턴트는 Channel.io 백엔드의 다양한 도메인 컨텍스트를 이해하고, 이를 바탕으로 보다 정확하고 맥락에 맞는 개발 지원을 제공할 수 있습니다.