knowdrift

knowdrift

knowdrift 将 MCP 客户端连接到按主题整理的网页爬取内容。它不会盲目搜索开放网络，而是先询问爬虫已覆盖哪些主题，然后从与你的问题匹配的主题中提取归档文档。返回的答案是按相关性排序的文档，均来自实际爬取并编入索引的页面。

此软件包是一个轻量级转发客户端。一端通过 stdio 使用 MCP，另一端通过可流式传输的 HTTP 将每次工具调用转发到公开的远程服务，并返回远程服务发送的内容。

工具

list-topics

不接受任何参数。返回目前已有爬取内容的主题名称，让你在搜索前了解索引覆盖的主题领域。

search

在指定主题中检索与问题最匹配的文档。

参数	类型	必填	说明
topics	array of string	是	一个或多个主题标识符，由 list-topics 返回。只会考虑归档在至少一个指定主题下的文档。
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。