knowdrift

knowdrift

knowdrift は、トピックごとに整理されたウェブクロールに MCP クライアントを接続します。オープンウェブを手当たり次第に検索するのではなく、まずクローラーがすでにカバーしているトピックを確認し、質問に合致するトピックに分類されたドキュメントを取得します。回答として、実際にクロールされ、インデックス化されたページから選ばれた、関連度順のドキュメントが返されます。

このパッケージは、薄い転送クライアントです。一方では stdio 経由で MCP を使用し、もう一方では各ツール呼び出しをストリーミング可能な HTTP 経由で公開リモートサービスに中継し、リモートから返された内容をそのまま返します。

ツール

list-topics

引数は不要です。現在クロール済みのコンテンツが利用可能なトピック名を返すため、検索前にインデックスがカバーしている分野を確認できます。

search

選択したトピックの中から、質問に最もよく一致するドキュメントを取得します。

引数	型	必須	備考
topics	array of string	はい	list-topics が返す、1 つ以上のトピック識別子です。これらのトピックの少なくとも 1 つに分類されたドキュメントのみが対象となります。
query	string	はい	意味的な関連度に基づいてドキュメントを順位付けするための、自然言語による質問です。
topK	number	いいえ	返すドキュメントの最大数です。1～30 を指定できます。デフォルトは 10 で、関連度の高い順に返されます。

CLI の使用方法

npx @reneturcios/knowdrift list-topics
npx @reneturcios/knowdrift search '{"topics":["technology"],"query":"How do vector databases work?","topK":5}'
npx @reneturcios/knowdrift --version

ツールのサブコマンドは、ツールの引数を単一の JSON オブジェクト文字列として受け取り、結果の最初のテキストブロックを出力します。終了コードは、成功時が 0、呼び出しがエラー結果を返した場合が 1、使用方法に誤りがある場合が 2 です。

MCP の使用方法

mcp サブコマンドで stdio サーバーを起動します。

npx -y @reneturcios/knowdrift mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "knowdrift": {
      "command": "npx",
      "args": ["-y", "@reneturcios/knowdrift", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/knowdrift
docker run --rm ghcr.io/cloudcorprecords/knowdrift search '{"topics":["technology"],"query":"What is new in quantum computing?"}'

引数を指定しない場合、コンテナは stdio MCP サーバーを実行します。それ以外の引数は CLI に渡されます。

設定

変数	デフォルト	用途
DRIFLYTE_MCP_URL	https://mcp.driflyte.com/mcp	呼び出しの転送先となる上流リモート MCP エンドポイントを上書きします。
REQUEST_TIMEOUT_MS	30000	上流への呼び出しに適用される、リクエストごとのタイムアウト時間（ミリ秒）です。

アカウントや API キーは不要です。上流サービスは公開されています。上流に接続できない場合や、エラーが返された場合、ツールはドキュメントを捏造するのではなく、テキストが knowdrift error: で始まるエラー結果を返します。

開発

npm install
npm run build
npm test
npm run dev

テストスイートは完全にオフラインで実行できます。スタブ化された JSON-RPC 上流に対して転送ロジックを実行し、提供されるツールの一覧がドキュメントに記載されたツールの範囲と一致することを確認します。

ライセンス

MIT — LICENSE を参照してください。