Falkordb

🚀 FalkorDB MCP サーバー

FalkorDB 用に実装されたモデルコンテキストプロトコル（MCP）サーバーです。これにより、AI モデルがグラフデータベースを照会し、相互作用することが可能です。

🚀 クイックスタート

このプロジェクトは、モデルコンテキストプロトコル（MCP）の仕様に準拠したサーバーを実装しており、AI モデルと FalkorDB グラフデータベースを接続します。このサーバーは、MCP リクエストを変換して FalkorDB にルーティングし、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 ファイル内の環境変数を使用して設定を管理します：

使用方法

開発環境

ホットリロード機能付きで開発サーバーを起動します：

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

💡 貢献

貢献を歓迎します！自由に Pull Request を送信してください。