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 分