# driftnet

driftnet catalogs links shared in group chats into a local SQLite store. Lets your coding agent search and inspect saved articles and tools.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 27 repo stars
- Author: KevinChu1110
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/KevinChu1110/driftnet
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/driftnet

## What it does

This MCP server links your development agent to a local `driftnet` archive. When you throw social posts or browser links into the queue, the tool looks up mentioned GitHub projects, pulls out previews, and sorts items into topical folders. Posts that merely cite a software name without an exact URL still get resolved to their real repository.

Everything sits on your machine inside SQLite. Running it requires Node.js 22.13 or newer. The setup functions with remote LLM keys, local Ollama models, or no model at all, grouping raw links under an unsorted folder when no AI provider is configured. It also rejects calls to private or internal network addresses.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DRIFTNET_HOME`, `DRIFTNET_LLM_PROVIDER`, `DRIFTNET_LLM_MODEL`, `DRIFTNET_LLM_API_KEY`, `DRIFTNET_LLM_BASE_URL`, `DRIFTNET_LLM_REGION`, `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_BEARER_TOKEN_BEDROCK`, `GOOGLE_APPLICATION_CREDENTIALS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DRIFTNET_HOME=<DRIFTNET_HOME> --env DRIFTNET_LLM_PROVIDER=<DRIFTNET_LLM_PROVIDER> --env DRIFTNET_LLM_MODEL=<DRIFTNET_LLM_MODEL> --env DRIFTNET_LLM_API_KEY=<DRIFTNET_LLM_API_KEY> --env DRIFTNET_LLM_BASE_URL=<DRIFTNET_LLM_BASE_URL> --transport stdio driftnet -- npx -y driftnet
```
Replace <…> with your own values. 10 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add driftnet --env DRIFTNET_HOME=<DRIFTNET_HOME> --env DRIFTNET_LLM_PROVIDER=<DRIFTNET_LLM_PROVIDER> --env DRIFTNET_LLM_MODEL=<DRIFTNET_LLM_MODEL> --env DRIFTNET_LLM_API_KEY=<DRIFTNET_LLM_API_KEY> --env DRIFTNET_LLM_BASE_URL=<DRIFTNET_LLM_BASE_URL> -- npx -y driftnet
```
Replace <…> with your own values. 10 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "driftnet": {
            "command": "npx",
            "args": [
                "-y",
                "driftnet"
            ],
            "env": {
                "DRIFTNET_HOME": "<DRIFTNET_HOME>",
                "DRIFTNET_LLM_PROVIDER": "<DRIFTNET_LLM_PROVIDER>",
                "DRIFTNET_LLM_MODEL": "<DRIFTNET_LLM_MODEL>",
                "DRIFTNET_LLM_API_KEY": "<DRIFTNET_LLM_API_KEY>",
                "DRIFTNET_LLM_BASE_URL": "<DRIFTNET_LLM_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. 10 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "driftnet": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "driftnet"
            ],
            "env": {
                "DRIFTNET_HOME": "<DRIFTNET_HOME>",
                "DRIFTNET_LLM_PROVIDER": "<DRIFTNET_LLM_PROVIDER>",
                "DRIFTNET_LLM_MODEL": "<DRIFTNET_LLM_MODEL>",
                "DRIFTNET_LLM_API_KEY": "<DRIFTNET_LLM_API_KEY>",
                "DRIFTNET_LLM_BASE_URL": "<DRIFTNET_LLM_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. 10 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DRIFTNET_HOME=<DRIFTNET_HOME> -e DRIFTNET_LLM_PROVIDER=<DRIFTNET_LLM_PROVIDER> -e DRIFTNET_LLM_MODEL=<DRIFTNET_LLM_MODEL> -e DRIFTNET_LLM_API_KEY=<DRIFTNET_LLM_API_KEY> -e DRIFTNET_LLM_BASE_URL=<DRIFTNET_LLM_BASE_URL> driftnet npx -y driftnet
```
Replace <…> with your own values. 10 more environment variables are in the server README

## When to use it
- search saved chat links and repositories from your coding assistant
- extract exact GitHub projects mentioned inside social posts
- keep a searchable local SQLite index of research bookmarks
- inspect web summaries without visiting cluttered source pages

## Example prompts
- Search my driftnet catalogue for vector database tools
- List recent project cards saved under the AI folder in driftnet
- Check driftnet for links related to sqlite migrations

## Similar
- [fieldtheory-cli-bookmarks](https://affpapa.org/en/nevibecode/skills/fieldtheory-cli-bookmarks.md) — skill · 635 installs
- [Linkedmash](https://affpapa.org/en/nevibecode/mcp/linkedmash.md) — MCP server · 204 installs
- [cubox](https://affpapa.org/en/nevibecode/skills/cubox.md) — skill · 1200 installs
- [karakeep](https://affpapa.org/en/nevibecode/skills/karakeep.md) — skill · 574 installs
- [Stashhh](https://affpapa.org/en/nevibecode/mcp/stashhh.md) — MCP server
- [MoonlyBox MoonLink](https://affpapa.org/en/nevibecode/mcp/moonlybox-moonlink.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
