@activefs/mcp

MCP adapter and server helpers for exposing ActiveFS trees as resources, tools, and prompts.

Use this package when an MCP client should browse or read an ActiveFS remote. The package also provides the activefs-mcp binary.

Install

npm install @activefs/mcp @activefs/core

Requires Node.js 20 or newer.

Small Example

import { createActiveFS, fsTree, text } from "@activefs/core";
import { createMCPAdapter } from "@activefs/mcp";

const tree = fsTree({
  "/README.md": text("# Docs\n")
});

const activefs = createActiveFS().mount("/docs", tree);

const adapter = createMCPAdapter({
  filesystem: activefs,
  remotes: [{ name: "docs", rootPath: "/docs" }]
});

const resources = await adapter.listResources();
const readme = await adapter.readResource("activefs://docs/README.md");

console.log(resources.resources.length);
console.log(readme.contents[0]?.text);

Binary

activefs-mcp --help
activefs-mcp --dry-run --demo
activefs-mcp --http --port 8765 --auth none --demo

What It Owns

• ActiveFS-to-MCP resource mapping.
• activefs://remote/path resource URIs.
• Stdio and Streamable HTTP MCP server helpers.
• Optional grep/tool/prompt surfaces over ActiveFS resources.

Docs

• MCP: https://github.com/ankitparasher/activefs/blob/main/docs/guides/mcp.md
• CLI MCP commands: https://github.com/ankitparasher/activefs/blob/main/docs/reference/cli.md
• Source API: https://github.com/ankitparasher/activefs/blob/main/docs/reference/source-api.md