Hdfs MCP Server

HDFS MCP Server is a controller based on MCP (Model Context Protocol) that provides access to HDFS clusters through the MCP protocol. The server

Local serverstdioPython

What is the Hdfs MCP Server?

HDFS MCP Server is a controller based on MCP (Model Context Protocol) that provides access to HDFS clusters through the MCP protocol. The server supports basic HDFS

What it actually does

  • List directory contents
  • Read file contents
  • Create directories
  • Delete files/directories
  • Upload files to HDFS
  • Download files from HDFS

Configuration

  • Python 3.11 or higher - Hadoop client installed and configured - uv package manager

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Hdfs MCP Server

{
  "mcpServers": {
    "hdfs-controller": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/hdfsmcp",
        "run",
        "hdfs.py"
      ],
      "env": {
        "HDFS_NAMENODE": "your_namenode_hostname",
        "NAMENODE_PORT": "your_namenode_port"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.11 or higher - Hadoop client installed and configured - uv package manager
VariableDescriptionRequired
HDFS_NAMENODEDeclared in the maintainer’s client configuration.Check documentation
NAMENODE_PORTDeclared in the maintainer’s client configuration.Check documentation

Frequently asked questions

HDFS MCP Server is a controller based on MCP (Model Context Protocol) that provides access to HDFS clusters through the MCP protocol. The server supports basic HDFS Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.