FalkorDB MCP Server

Integrations

  • Provides configuration management for the MCP server through environment variables stored in a .env file.

  • Allows running the FalkorDB MCP server in a containerized environment with network configuration for connecting to FalkorDB instances.

  • Supports repository cloning as part of the installation process for the FalkorDB MCP server.

FalkorDB MCP 서버

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

개요

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

필수 조건

  • 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

-
security - not tested
A
license - permissive license
-
quality - not tested

AI 모델이 MCP(Model Context Protocol) 사양을 통해 FalkorDB 그래프 데이터베이스를 쿼리하고 상호 작용할 수 있도록 합니다.

  1. Overview
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Usage
            1. Development
            2. Production
          2. API Endpoints
            1. MCP Configuration
              1. Contributing
                1. License
                  ID: 0r7jit736n