OpenCRAVAT MCP 서버

이 저장소는 OpenCRAVAT 기반 변이 주석을 호출 가능한 도구로 노출하는 MCP(Model Context Protocol) 서버를 포함합니다. 이 서버는 Cloudflare Worker(Wrangler 사용)로 실행되며 공개 OpenCRAVAT 서비스로 요청을 프록시합니다.

이 서버가 제공하는 기능

이 서버는 MCP 클라이언트가 다음을 수행할 수 있도록 MCP 도구를 노출합니다:

• 실행 중인 OpenCRAVAT 주석 도구 확인 (기본적으로 선별된 세트).

• 주석 도구 출력 스키마 검사 (필드 이름/유형/설명).

• 다음을 통한 변이 주석 처리:

  • 유전체 좌표 (chrom/pos/ref/alt). GRCh38/hg38 좌표만 허용합니다.

  • dbSNP rsID

  • ClinGen Allele Registry ID (CAid)

  • HGVS (g./c./p.)

• 단백질 미스센스 표기법(예: BRAF V600E)을 후보 GRCh38 유전체 HGVS 변경 사항으로 변환(SynVar 사용), 이후 HGVS 주석 처리에 전달 가능.

연결 방법

이 MCP 서버는 다음 원격 주소에서 호스팅됩니다:

https://mcp.opencravat.org/sse

로컬에서 실행할 수도 있습니다.

Claude

Claude에 연결하려면 이 지침을 따르세요. 위 URL을 사용하고 인증은 설정하지 마세요. MCP가 작동하는 데 사용자별 데이터는 필요하지 않습니다. 채팅에서 MCP를 활성화하는 것을 잊지 마세요.

ChatGPT

ChatGPT에 연결하려면 개발자 모드를 활성화한 다음 사용자 지정 앱을 추가해야 합니다:

• 설정 열기

• 앱으로 이동

• 고급 설정에서 토글을 사용하여 “개발자 모드” 켜기

• 앱 만들기 클릭

• 위 URL을 “MCP 서버 URL”로 사용

• 인증을 “인증 없음”으로 설정

• “OpenCRAVAT”와 같이 쉽게 알아볼 수 있는 이름을 MCP 앱에 추가

채팅창 왼쪽 하단의 + 아이콘을 사용하여 새 채팅에 MCP를 추가해야 합니다.

로컬에서 실행하기

사전 요구 사항:

• Node.js (최신 TypeScript 도구에 충분한 버전; Node 18+ 권장)

• npm

의존성 설치:

npm install

개발 서버 시작 (Wrangler):

npm start

기본적으로 MCP 엔드포인트는 다음과 같습니다:

http://localhost:8787/sse

Claude Desktop 연결

Claude Desktop에서 MCP 서버에 연결하려면 Anthropic의 퀵스타트를 따르고 Claude Desktop 내에서 설정 > 개발자 > 구성 편집으로 이동하세요.

다음 구성으로 업데이트하세요:

{
  "mcpServers": {
    "OpenCRAVAT": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

Claude를 다시 시작하면 도구를 사용할 수 있게 됩니다.