io.github.bytedance/mcp-server-filesystem

Official

by bytedance · TypeScript

MCP server for filesystem access

The Model Context Protocol (MCP) server io.github.bytedance/mcp-server-filesystem provides filesystem access via the MCP interface. Its catalog description is “MCP server for filesystem access,” and the available metadata includes topics related to agent and multimodal workflows such as agent, mcp, and multimodal.

🛠️ Key Features

Filesystem access through an MCP server
Package identified as @agent-infra/mcp-server-filesystem

🚀 Use Cases

Agent-driven file operations using MCP
Multimodal or GUI-style agent workflows that require local filesystem access (gui-agent, computer-use)

⚡ Developer Benefits

Standard MCP integration for tooling that needs filesystem reads/writes
Discoverable installation paths for MCP clients (NPM and Cursor/VS Code install links)

⚠️ Limitations

No additional capabilities, permissions model, or supported operations are specified in the provided data

Topics

agentvlmvisioncomputer-usemcpmcp-servergui-operatorbrowser-usegui-agentmultimodaltarsui-tarsagent-tarscowork

packages/agent-infra/mcp-servers/filesystem/README.md5 KBView on GitHub

FileSystem MCP Server

A Model Context Protocol (MCP) server that provides filesystem operations.

image

Requirements

Node.js 18 or newer
VS Code, Cursor, Windsurf, Claude Desktop or any other MCP client

Getting started

Local (Stdio)

First, install the Filesystem MCP server with your client. A typical configuration looks like this:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "@agent-infra/mcp-server-filesystem@latest"
      ]
    }
  }
}

Install in VS Code

You can also install the Filesystem MCP server using the VS Code CLI:

bash

# For VS Code
code --add-mcp '{"name":"filesystem","command":"npx","args":["@agent-infra/mcp-server-filesystem@latest"]}'

After installation, the Filesystem MCP server will be available for use with your GitHub Copilot agent in VS Code.

Install in Cursor

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx @agent-infra/mcp-server-filesystem. You can also verify config or add command like arguments via clicking Edit.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "@agent-infra/mcp-server-filesystem@latest",
        "--allowed-directories /tmp"
      ]
    }
  }
}

Install in Windsurf

Follow Windsuff MCP documentation. Use following configuration:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "@agent-infra/mcp-server-filesystem@latest",
        "--allowed-directories /tmp"
      ]
    }
  }
}

Install in Claude Desktop

Follow the MCP install guide, use following configuration:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "@agent-infra/mcp-server-filesystem@latest",
        "--allowed-directories /tmp"
      ]
    }
  }
}

Remote (SSE / Streamable HTTP)

At the same time, use --port $your_port arg to start the browser mcp can be converted into SSE and Streamable HTTP Server.

bash

# normal run remote mcp server
npx @agent-infra/mcp-server-filesystem --port 8089 --allowed-directories <dir>

You can use one of the two MCP Server remote endpoint:

Streamable HTTP(Recommended): http://127.0.0.1::8089/mcp
SSE: http://127.0.0.1::8089/sse

And then in MCP client config, set the url to the SSE endpoint:

{
  "mcpServers": {
    "filesystem": {
      "url": "http://127.0.0.1::8089/sse"
    }
  }
}

url to the Streamable HTTP:

{
  "mcpServers": {
    "filesystem": {
      "type": "streamable-http", // If there is MCP Client support
      "url": "http://127.0.0.1::8089/mcp"
    }
  }
}

In-memory call

If your MCP Client is developed based on JavaScript / TypeScript, you can directly use in-process calls to avoid requiring your users to install the command-line interface to use Filesystem MCP.

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';

// type: module project usage
import { createServer } from '@agent-infra/mcp-server-filesystem';
// commonjs project usage
// const { createServer } = await import('@agent-infra/mcp-server-filesystem')

const client = new Client(
  {
    name: 'test filesystem client',
    version: '1.0',
  },
  {
    capabilities: {},
  },
);

const server = createServer();
const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();

await Promise.all([
  client.connect(clientTransport),
  server.connect(serverTransport),
]);

// list tools
const result = await client.listTools();
console.log(result);

// call tool
const toolResult = await client.callTool({
  name: 'list_directory',
  arguments: {
    path: '~/your_computer'
  },
});
console.log(toolResult);

Development

Access http://127.0.0.1:6274/:

bash

npm run dev

Install

Configuration

Arguments

allowed-directoriesrequired

portrequireddefault 8089

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-server-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-filesystem@latest",
        "allowed-directories",
        "<YOUR_ALLOWED_DIRECTORIES>"
      ]
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

FileSystem MCP Server

Requirements

Getting started

Local (Stdio)

Remote (SSE / Streamable HTTP)

In-memory call

Development

Install

Configuration

Related servers