Knowdrift

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Search Driflyte's topic-indexed crawled web knowledge: list topics and retrieve documents.

已驗證STDIO僅桌面網頁搜尋與抓取知識與記憶

概覽

AI 產生的概覽

Knowdrift 讓助理列出依主題索引的網頁爬取所涵蓋的主題，並從該索引中擷取與問題最相關的文件。

可以做什麼
  • 列出目前已有爬取內容的主題
  • 在選定的一個或多個主題內搜尋，回傳依語意相關度排序的前 K 份文件（最多 30 份，預設 10 份）
  • 將每次呼叫轉送到公開的遠端服務並回傳結果，上游出錯時回傳錯誤結果
適用情境
適合希望根據經過整理、依主題組織的爬取內容作答，而非盲目搜尋開放網路的場合，且能接受索引已涵蓋的主題與文件範圍。
執行需求
以 stdio 本機程序執行，可透過 npx（需 Node.js）或 Docker 映像啟動，並以 streamable HTTP 轉送到公開遠端端點。不需帳號或 API 金鑰。可選環境變數 DRIFLYTE_MCP_URL（覆寫上游端點）與 REQUEST_TIMEOUT_MS（預設 30000）。
安裝前請注意
查詢內容與所選主題會傳送到所設定端點上的第三方遠端服務，請勿送出機密問題。設定 DRIFLYTE_MCP_URL 會把所有流量改送到其他主機。此伺服器為唯讀，上游失敗時回傳錯誤結果，不會憑空產生文件。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Knowdrift，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

knowdrift

knowdrift connects an MCP client to a web crawl that is organised by topic. Instead of searching the open web blindly, you first ask which topics the crawler has already covered, then pull the documents it filed under the topics that match your question. Answers come back as ranked documents drawn from pages that were actually crawled and indexed.

This package is a thin forwarding client. It speaks MCP over stdio on one side and relays each tool call to the public remote service over streamable HTTP on the other, returning whatever the remote sends back.

Tools

list-topics

Takes no arguments. Returns the names of the topics for which crawled content is currently available, so you can discover the subject areas the index covers before searching it.

search

Retrieves the documents that best match a question inside chosen topics.

ArgumentTypeRequiredNotes
topicsarray of stringyesOne or more topic identifiers, as returned by list-topics. Only documents filed under at least one of these topics are considered.
querystringyesThe natural-language question used to rank documents by semantic relevance.
topKnumbernoHow many documents to return at most, from 1 to 30. Defaults to 10; results arrive sorted by descending relevance.

CLI usage

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

The tool subcommands accept the tool's arguments as a single JSON object string and print the first text block of the result. Exit codes are 0 on success, 1 when the call returns an error result, and 2 for usage errors.

MCP usage

Start the stdio server with the mcp subcommand:

bash
npx -y @reneturcios/knowdrift mcp

MCP client configuration:

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

Docker

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

With no arguments the container runs the stdio MCP server; any other arguments are passed to the CLI.

Configuration

VariableDefaultPurpose
DRIFLYTE_MCP_URLhttps://mcp.driflyte.com/mcpOverrides the upstream remote MCP endpoint that calls are forwarded to.
REQUEST_TIMEOUT_MS30000Per-request timeout for upstream calls, in milliseconds.

No account or API key is needed: the upstream service is public. When the upstream cannot be reached or answers with an error, the tool returns an error result whose text begins with knowdrift error: rather than fabricating documents.

Development

bash
npm installnpm run buildnpm testnpm run dev

The test suite runs fully offline. It drives the forwarding logic against a stubbed JSON-RPC upstream and checks the served tool list against the documented tool surface.

License

MIT — see LICENSE.

來源：README.md，提交 72b8bb8

工具

2

list-topics

Returns a list of topics for which resources (web pages, etc ...) have been crawled and content is available. This allows AI assistants to discover the most relevant and up-to-date subject areas currently indexed by the crawler.

無需輸入參數。

版本歷史

1
  1. v0.1.0最新Nov 4, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分