Skip to content
MCP server

Wyrd

Serves one granted folder to any AI client, read-only, behind a path-containment fence

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.4.0
Listing updated
today

Similar MCP servers

About Wyrd

Wyrd is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Wyrd is a collection of MCP servers plus a containment library. The Reader server works over a single folder you grant explicitly and applies a documented path boundary, so the assistant cannot read outside that folder. It starts only if a folder is set, either with a --grant argument or the WYRD_GRANT variable, and refuses otherwise.

Install it from npm as wyrd-mcp; for Claude Code that is a one-line claude mcp add using npx. An optional search backend can replace the built-in search, but the registry entry warns that this module runs inside the server process and is not confined to the granted folder, so leave it unset unless you trust it.

The repository scaffold is MIT, each package carries its own licence file, and each package README documents its security boundary and known limits.

Install

Run in a terminal

claude mcp add wyrd -- npx -y wyrd-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "wyrd": {
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wyrd": {
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "wyrd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wyrd": {
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "wyrd": {
      "command": "npx",
      "args": [
        "-y",
        "wyrd-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • WYRD_GRANTAbsolute path to the single folder to serve, read-only. Used when --grant is not passed. The server refuses to start if neither is set.
  • WYRD_SEARCH_BACKENDOptional. Absolute path to one module file that answers search instead of the built-in search. Used when --search-backend is not passed. The module runs inside the server process and is not confined to the granted folder; leave unset unless you trust it.

What it does

Single granted folder
Operates over one folder you name.
Read-only access
Files can be read but not changed.
Path containment
A documented boundary keeps paths inside the grant.
Refuses without a grant
The server will not start unless a folder is set.
Pluggable search
An optional module can replace the built-in search, at your trust.

Good for

  • Let an assistant read project notes without exposing the rest of the disk
  • Search a documentation folder
  • Give an AI client read access to an archive
  • Keep file access narrow when testing a new client

Pricing

Open source

Wyrd FAQ

How do I grant a folder?

Pass --grant with the folder path or set WYRD_GRANT; the server refuses to start with neither.

Can it write files?

No, it is read-only.

Is the custom search backend safe?

The README warns it runs in the server process and is not confined to the folder, so only use trusted modules.

How do I install it?

From npm as wyrd-mcp, for example through npx.

Is Wyrd free?

Yes. Wyrd is open source, so you can use and self-host it for free.

How do I add Wyrd to Claude Code?

Run this command in your terminal: claude mcp add wyrd -- npx -y wyrd-mcp

What are the best alternatives to Wyrd?

The closest alternatives to Wyrd are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers