FalkorDB MCP 서버

FalkorDB용 MCP(Model Context Protocol) 서버로, AI 모델이 그래프 데이터베이스를 쿼리하고 상호 작용할 수 있도록 해줍니다.

개요

이 프로젝트는 AI 모델을 FalkorDB 그래프 데이터베이스와 연결하기 위해 모델 컨텍스트 프로토콜(MCP) 사양을 따르는 서버를 구현합니다. 이 서버는 MCP 요청을 FalkorDB로 변환하여 라우팅하고, MCP 표준에 따라 응답 형식을 지정합니다.

Related MCP server: db-mcp-tool

필수 조건

• Node.js(v16 이상)

• npm 또는 yarn

• FalkorDB 인스턴스(로컬 또는 원격으로 실행 가능)

설치

1. 이 저장소를 복제하세요:

   지엑스피1

2. 종속성 설치:

   npm install

3. 예제 환경 파일을 복사하여 구성합니다.

   cp .env.example .env

   구성 세부정보로 .env 편집합니다.

구성

구성은 .env 파일의 환경 변수를 통해 관리됩니다.

• PORT : 서버 포트(기본값: 3000)

• NODE_ENV : 환경(개발, 프로덕션)

• FALKORDB_HOST : FalkorDB 호스트(기본값: localhost)

• FALKORDB_PORT : FalkorDB 포트(기본값: 6379)

• FALKORDB_USERNAME : FalkorDB 인증을 위한 사용자 이름(필요한 경우)

• FALKORDB_PASSWORD : FalkorDB 인증을 위한 비밀번호(필요한 경우)

• MCP_API_KEY : MCP 요청 인증을 위한 API 키

용법

개발

핫 리로딩으로 개발 서버를 시작합니다.

npm run dev

생산

서버를 빌드하고 시작합니다.

npm run build
npm start

API 엔드포인트

• GET /api/mcp/metadata : FalkorDB 인스턴스 및 사용 가능한 기능에 대한 메타데이터를 가져옵니다.

• POST /api/mcp/context : FalkorDB에 대한 쿼리 실행

• GET /api/mcp/health : 서버 상태 확인

• GET /api/mcp/graphs : 그래프 목록을 반환합니다.

MCP 구성

이 서버를 MCP 클라이언트와 함께 사용하려면 MCP 구성에 다음을 추가하세요.

{
  "mcpServers": {
    "falkordb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p", "3000:3000",
        "--env-file", ".env",
        "falkordb-mcpserver",
        "falkordb://host.docker.internal:6379"
      ]
    }
  }
}

클라이언트 측 구성의 경우:

{
  "defaultServer": "falkordb",
  "servers": {
    "falkordb": {
      "url": "http://localhost:3000/api/mcp",
      "apiKey": "your_api_key_here"
    }
  }
}

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.