nginx-filesystem-mcp

hhxiao/nginx-filesystem-mcp

3.2

If you are the rightful owner of nginx-filesystem-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The nginx-filesystem-mcp server provides secure access to files served via nginx using the Model Context Protocol (MCP).

Tools

  1. listFolder

    Read a folder.

  2. readFile

    Read a file.

  3. treeFolder

    Returns a hierarchical JSON representation of a project's directory structure.

nginx-filesystem-mcp

This MCP server enables secure access to files served via nginx through the Model Context Protocol (MCP).

Configuration Guide

LangGraph Python Client

To configure the nginx-filesystem-mcp in a LangGraph-based Python client:

import os
from rest_mcp import MultiServerMCPClient

client = MultiServerMCPClient(
    {
        "nginx-file": {
            "url": "http://0.0.0.0:9292/mcp",
            "transport": "streamable_http",
            "headers": {
              "Authorization": os.getenv("TOKEN")
            }
        },
        "nginx-file-2": {
            "command": "docker",
            "args": ["run", "-i", "--rm",
                "-e", "TOKEN=<nginx_token>",
                "-e", "INSECURE_SKIP_VERIFY=true",
                "-e", "CONTENT_BASEURL=<nginx_base_url>",
                "ghcr.io/hhxiao/nginx-filesystem-mcp:latest",
                "-t",
                "stdio"
            ],
            "transport": "stdio"
        }
    }
)

VS Code (mcp.json)

To configure the nginx-filesystem-mcp for use in VS Code:

{
  "servers": {
    "nginx-file": {
      "type": "http",
      "url": "http://0.0.0.0:9292/mcp",
      "headers": {
        "Authorization": "<TOKEN>"
      }
    },
    "nginx-file-2": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm",
          "-e", "INSECURE_SKIP_VERIFY=true",
          "-e", "TOKEN=<nginx_token>",
          "-e", "CONTENT_BASEURL=<nginx_base_url>",
          "ghcr.io/hhxiao/nginx-filesystem-mcp:latest",
          "-t",
          "stdio"
      ]
    }
  }
}

Tools

The following tools are available in nginx-filesystem-mcp:

listFolder

  • Description: Read a folder.
  • Input Schema:
    • path (string, optional): Path of the directory to list.
  • Read-Only: Yes

readFile

  • Description: Read a file.
  • Input Schema:
    • path (string, required): Path to the file to read.
  • Read-Only: Yes

treeFolder

  • Description: Returns a hierarchical JSON representation of a project's directory structure.
  • Input Schema:
    • path (string, optional): Path of the directory to traverse.
  • Read-Only: Yes

Resource Templates

The following resource templates are supported by the nginx-filesystem-mcp:

files://{path}

  • Name: File
  • Description: Return path information for a folder or a file.
  • MIME Type: application/json