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) サーバー。AI モデルがグラフ データベースをクエリして対話できるようにします。

概要

このプロジェクトは、モデルコンテキストプロトコル(MCP)仕様に準拠したサーバーを実装し、AIモデルをFalkorDBグラフデータベースに接続します。このサーバーは、MCPリクエストをFalkorDBにルーティングし、MCP標準に従ってレスポンスをフォーマットします。

前提条件

  • Node.js (v16以降)
  • npmまたはyarn
  • FalkorDB インスタンス (ローカルまたはリモートで実行可能)

インストール

  1. このリポジトリをクローンします:
    git clone https://github.com/falkordb/falkordb-mcpserver.git cd falkordb-mcpserver
  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 ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

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

AI モデルがモデル コンテキスト プロトコル (MCP) 仕様を通じて 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