Repolode
dosco

dosco/graphjin

데이터베이스, 파일, 코드를 GraphQL과 MCP로 AI 에이전트에 제공하는 Go 컴파일러이자 런타임으로, 접근을 제어하고 실행 과정을 감사할 수 있습니다.

스타
3,234
포크
206
열린 이슈
18
마지막 커밋
19시간 전

어떤 프로젝트인가요?

GraphJin은 GraphQL 쿼리를 PostgreSQL, MySQL, MongoDB, SQLite, Oracle, MSSQL 같은 데이터베이스용 SQL로 컴파일하고, REST, 실시간 구독, Apollo Federation 서브그래프도 제공합니다. 테이블 간 관계를 탐색 가능한 조인으로 표현해, resolver나 ORM 없이도 GraphQL 요청 하나를 최적화된 쿼리 하나로 변환합니다.

AI 에이전트에는 모델이 스키마를 탐색하고 필터를 검증하며, 데이터베이스의 원시 자격 증명을 직접 보유하지 않고 승인된 저장 쿼리를 실행할 수 있는 MCP 인터페이스를 제공합니다. 또한 tree-sitter로 소스 코드를 인덱싱해 SQLite 캐시(CodeSQL)에 저장하고, S3, GCS, 로컬 파일 같은 객체 스토리지를 테이블로 노출합니다. 서버 측 에이전트 엔드포인트와 구독을 다시 실행하고 변경 사항을 inbox에 기록하는 watches도 포함되어 있습니다.

프로젝트는 단일 바이너리로 제공되며 npm, Homebrew, Scoop, Docker, deb/rpm 패키지도 지원합니다. 로컬에서 시험해 볼 수 있도록 데모와 웹 콘솔도 내장되어 있습니다.

핵심 기능

  • 01여러 데이터베이스에서 GraphQL 쿼리를 최적화된 단일 SQL 문으로 컴파일합니다.
  • 02데이터베이스, 객체 스토리지, 소스 코드를 하나의 GraphQL 및 MCP 인터페이스로 제공합니다.
  • 03스키마 탐색, 필터 검증, 승인된 쿼리 실행을 위한 MCP 도구를 제공합니다.
  • 04WebSocket과 Server-Sent Events를 통한 실시간 구독을 지원합니다.
  • 05tree-sitter로 소스 트리를 인덱싱해 데이터를 조회하듯 코드를 쿼리할 수 있습니다.
  • 06서버 측 에이전트 엔드포인트와 함께 결과를 inbox 또는 webhook으로 전달하는 watches를 제공합니다.

활용 사례

  • 원시 자격 증명을 공유하지 않고 AI 어시스턴트에 프로덕션 데이터베이스 읽기 권한을 부여합니다.
  • resolver를 작성하지 않고 기존 SQL 데이터베이스 위에 GraphQL API를 구축합니다.
  • GraphQL이나 REST에서 객체 스토리지의 파일을 데이터베이스 테이블처럼 조회합니다.
  • 데이터베이스 테이블과 이를 사용하는 소스 코드를 함께 연결해 질문에 답합니다.

빠른 시작

  1. 1

    npm으로 GraphJin 설치

    npm install -g graphjin
  2. 2

    내장 데모 앱 실행

    graphjin serve --demo

사용 전 알아둘 점

  • 내장 AI 에이전트를 사용하려면 OpenAI, Anthropic 또는 Google의 모델 API 키가 필요합니다.
  • 데모와 예제는 SQLite 및 Docker 기반 환경에서 실행되므로, 자체 데이터베이스에 연결하려면 앱을 만들고 구성해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

graphjin은(는) 무엇인가요?
데이터베이스, 파일, 코드를 GraphQL과 MCP로 AI 에이전트에 제공하는 Go 컴파일러이자 런타임으로, 접근을 제어하고 실행 과정을 감사할 수 있습니다. GraphJin은 GraphQL 쿼리를 PostgreSQL, MySQL, MongoDB, SQLite, Oracle, MSSQL 같은 데이터베이스용 SQL로 컴파일하고, REST, 실시간 구독, Apollo Federation 서브그래프도 제공합니다. 테이블 간 관계를 탐색 가능한 조인으로 표현해, resolver나 ORM 없이도 GraphQL 요청 하나를 최적화된 쿼리 하나로 변환합니다.
graphjin은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
graphjin은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
graphjin은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. graphjin의 마지막 커밋은 2026년 11월 6일입니다.
graphjin은(는) 어디에 사용할 수 있나요?
원시 자격 증명을 공유하지 않고 AI 어시스턴트에 프로덕션 데이터베이스 읽기 권한을 부여합니다. resolver를 작성하지 않고 기존 SQL 데이터베이스 위에 GraphQL API를 구축합니다. GraphQL이나 REST에서 객체 스토리지의 파일을 데이터베이스 테이블처럼 조회합니다. 데이터베이스 테이블과 이를 사용하는 소스 코드를 함께 연결해 질문에 답합니다.
graphjin는 어떻게 설치하나요?
npm으로 GraphJin 설치: npm install -g graphjin 내장 데모 앱 실행: graphjin serve --demo
graphjin은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/dosco/graphjin

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트