Toolfront

🚀 ToolFront

AIエージェントはデータベースに関するコンテキストを欠いており、チームは過去の作業が失われることが多いため、同じクエリを何度も書き直しています。ToolFrontはエージェントをデータベースに接続し、チームの実績のあるクエリパターンを提供するため、エージェントとチームメイトは互いに学び、より迅速に成果を出すことができます。

✨ 主な機能

• ⚡ ワンステップセットアップ：Cursor、GitHub Copilot、Claudeなどのコーディングエージェントを1つのコマンドまたは設定ですべてのデータベースに接続できます。
• 🔒 プライバシー重視：データは決してあなたの環境を離れず、エージェントとデータベース間でのみ安全なMCPサーバーを介して共有されます。
• 🧠 協調学習：チームがToolFrontを使えば使うほど、AIエージェントがデータベースとクエリパターンをよりよく理解します。APIキーが必要です。

🚀 クイックスタート

ToolFrontはMCPサーバーを通じてあなたのコンピューター上で実行されます。MCPはアプリがLLMモデルにコンテキストを提供できる安全なプロトコルです。

前提条件

• MCPサーバーを実行するための**uvまたはDocker**（uvを推奨）
• データベースのデータベース接続URL - 以下を参照
• 協調学習を有効にするためのAPIキー（オプション） - 以下を参照

IDEでToolFrontを実行する

まず、上のセットアップボタンをクリックするか、IDEのMCP設定に移動してMCP設定を作成します。

次に、データベース接続URLとオプションのAPIキーでMCP設定を編集します。

{
  // 設定ファイルの残りの部分
  "toolfront": {
    "command": "uvx",
    "args": [
      "toolfront",
      "snowflake://user:pass@org",
      "postgresql://user:pass@host:port/db",
      # ここに他のデータベースURLを追加
      "--api-key", "YOUR-API-KEY"  // オプション
    ]
  }
}

{
  // 設定ファイルの残りの部分
  "toolfront": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "antidmg/toolfront",
      "snowflake://user:pass@org",
      "postgresql://user:pass@host:port/db",
      # ここに他のデータベースURLを追加
      "--api-key", "YOUR-API-KEY"  // オプション
    ]
  }
}

これで設定完了です！これからコーディングアシスタントにデータベースに関する質問をすることができます。

💡 使用アドバイス

一貫性を保つために特定のバージョンを指定できます。UVの場合はtoolfront==0.1.x、Dockerの場合はantidmg/toolfront:0.1.xを使用します。

ターミナルからToolFrontを実行する

IDEの外でToolFrontを使用するには、データベースURLとオプションのAPIキーを指定してターミナルから直接実行します。

# UVを使用する場合
uvx toolfront "snowflake://user:pass@org" "postgresql://user:pass@host:port/db" --api-key "YOUR-API-KEY"

# Dockerを使用する場合  
docker run -i antidmg/toolfront "snowflake://user:pass@org" "postgresql://user:pass@host:port/db" --api-key "YOUR-API-KEY"

💡 使用アドバイス

ローカルホストで実行されているデータベースに接続する場合は、イメージ名の前に--network hostを追加します。

協調的な文脈内学習

データチームは過去の作業が孤立し、散在し、または失われることが多いため、同じクエリを何度も書き直しています。ToolFrontは文脈内学習を通じて、AIエージェントにチームがデータベースを操作する方法を教えます。ToolFrontを使用すると、エージェントは以下のことができます。

• 過去のクエリパターンを分析する
• 関連するテーブルとスキーマを記憶する
• あなたとチームメイトの作業を参照する

⚠️ 重要な注意

文脈内学習は現在オープンベータ版です。APIキーをリクエストするには、esteban@kruskal.aiまでメールを送信するか、Discordサーバーに参加してください。

データベース

ToolFrontは以下のデータベースをサポートしています。

あなたのデータベースがリストにない場合は、問題を提出するか、プルリクエストを送信するか、Discordでお知らせください。

💡 使用アドバイス

SSHトンネリング：SSHバスションの背後にあるデータベースの場合は、URLにSSHパラメータを追加します。例：postgresql://user:pass@db:5432/database?ssh_host=bastion&ssh_user=ubuntu&ssh_password=pass またはキー認証の場合は ssh_key_path=/path/to/key.pem を使用します。

ローカルデータファイルを扱う場合：ローカルのParquet、CSV、Excel、またはJSONファイルを分析するには、設定に duckdb://:memory: を追加します。

ツール

MCPツールはAIエージェントが外部システムとやり取りするために呼び出すことができる関数です。ToolFrontには7つのデータベースツールが付属しています。

FAQ

サポートとコミュニティ

ToolFrontに関するヘルプが必要な場合は、以下の方法でお問い合わせください。

• Discord：リアルタイムのヘルプと議論のためにコミュニティサーバーに参加してください。
• 問題報告：GitHub Issuesでバグを報告するか、機能リクエストを行ってください。

貢献方法

ToolFrontに貢献する方法については、CONTRIBUTING.mdを参照してください。

📄 ライセンス

ToolFrontはMITライセンスの下で公開されています。これは、MITライセンスの条件に従い、ソフトウェアを自由に使用、変更、および配布できることを意味します。完全なライセンステキストについては、リポジトリ内のLICENSEファイルを参照してください。