Mcp Server Filesystem

io.github.bytedance由 GitHub 帳號 bytedance 發布v1.0.0更新於 Oct 24, 2026

MCP server for filesystem access

已驗證STDIO僅桌面檔案與儲存開發者工具

概覽

AI 產生的概覽

一個本機 MCP 伺服器，讓 AI 助理在使用者電腦上執行檔案系統操作，並可透過允許目錄參數限制存取範圍。

可以做什麼
列出並檢視本機上的目錄與檔案，README 以 list_directory 工具為例（完整工具清單未公布）。透過 npx 以本機 stdio 程序執行，也可在指定連接埠上以 SSE 或 Streamable HTTP 方式提供。可在 JavaScript 或 TypeScript 的 MCP 用戶端中於程序內呼叫，不必安裝命令列工具。透過允許目錄參數把存取限制在指定資料夾。
適用情境
當助理需要讀取或處理使用者自己電腦上的檔案時適用，例如在 VS Code、Cursor、Windsurf 或 Claude Desktop 中使用，並希望把範圍限制在選定的資料夾內。
執行需求
需要 Node.js 18 或更新版本，以及 VS Code、Cursor、Windsurf、Claude Desktop 等 MCP 用戶端。透過 npm 套件以 npx 在本機執行，也可指定連接埠啟動 SSE 或 Streamable HTTP。未宣告驗證、環境變數或標頭。
安裝前請注意
它讓助理取得本機檔案系統存取權，應使用允許目錄參數限定範圍，避免開放過大權限。README 未說明哪些操作會寫入、修改或刪除檔案；應假定可能有修改檔案的工具有使用前確認。遠端模式啟動時未宣告驗證，應僅綁定在本機。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Server Filesystem，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

FileSystem MCP Server

[NPM Downloads]

[Install MCP Server] [Install in VS Code] [Install in VS Code Insiders]

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

[圖片]

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:

js
{  "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 Codecode --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.

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

Follow Windsuff MCP documentation. Use following configuration:

js
{  "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:

js
{  "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 servernpx @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:

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

url to the Streamable HTTP:

js
{  "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.

js
import { Client } from '@modelcontextprotocol/sdk/client/index.js';import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
// type: module project usageimport { 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 toolsconst result = await client.listTools();console.log(result);
// call toolconst 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

來源：packages/agent-infra/mcp-servers/filesystem/README.md，提交 2ff41a9

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分