FalkorDB MCP サーバー

FalkorDB 用のモデル コンテキスト プロトコル (MCP) サーバー。AI モデルがグラフ データベースをクエリして対話できるようにします。

概要

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

Related MCP server: db-mcp-tool

前提条件

• 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ファイルを参照してください。