How do I install Knowdrift?

Knowdrift is a local plugin. Install it using npm package: @reneturcios/knowdrift and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Knowdrift safe to use?

Knowdrift was flagged by MCP Marketplace's security scan, scoring 4.9/10 (high risk). It has 2 high or critical findings to review. Review the security report on this page carefully before installing it.

What AI apps work with Knowdrift?

Knowdrift uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Knowdrift MCP Server

by CloudCorpRecords

Developer ToolsUse Caution4.9MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

4.9

Use Caution4.9High Risk

knowdrift is a thin forwarder that relays list-topics and search calls to a keyless public remote endpoint (mcp.driflyte.com) and returns upstream results verbatim. The main concerns are that user queries leave the machine for a third-party service and that crawled upstream content is passed unfiltered to the AI assistant, which creates an indirect prompt-injection surface. Permissions are limited to outbound HTTP and an env var override, which match the stated purpose. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub 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.

Argument	Type	Required	Notes
`topics`	array of string	yes	One or more topic identifiers, as returned by `list-topics`. Only documents filed under at least one of these topics are considered.
`query`	string	yes	The natural-language question used to rank documents by semantic relevance.
`topK`	number	no	How many documents to return at most, from 1 to 30. Defaults to 10; results arrive sorted by descending relevance.

CLI usage

npx @reneturcios/knowdrift list-topics
npx @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:

npx -y @reneturcios/knowdrift mcp

MCP client configuration:

{
  "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?"}'

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

Configuration

Variable	Default	Purpose
`DRIFLYTE_MCP_URL`	`https://mcp.driflyte.com/mcp`	Overrides the upstream remote MCP endpoint that calls are forwarded to.
`REQUEST_TIMEOUT_MS`	`30000`	Per-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

npm install
npm run build
npm test
npm 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.

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.