axross headless MCP

● Active

io.github.c0decave/axross-headless-mcp

One MCP server for almost every file system: local, SFTP, SMB, NFS, WebDAV, S3, Azure, cloud drives.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "axross-headless-mcp": {
      "command": "uvx",
      "args": [
        "axross-headless-mcp"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add axross-headless-mcp -- uvx axross-headless-mcp
OpenAI Codex CLI
codex mcp add axross-headless-mcp -- uvx axross-headless-mcp
VS Code
code --add-mcp '{"name":"axross-headless-mcp","type":"stdio","command":"uvx","args":["axross-headless-mcp"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Files & Storage
Version
0.15.183
Registry
active
Published
11/21/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Mostly fine: axross headless MCP is maintained.

Maintained
Active
Last commit 2 days ago (Nov 20, 2026), 0 open issues.
Official registry
Active
Published as io.github.c0decave/axross-headless-mcp in the official MCP registry, version 0.15.183.
Source
No licence found
Public repository, but GitHub reports no recognised licence (0 stars). Check the README before shipping it in a product.
Runs
On your machine
A local PyPI/Docker package started by your client; it can reach whatever your user account can.
Credentials
None declared
The registry entry declares no required environment variables.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 21, 2026
Stars
0
Forks
0
Last push
Nov 20, 2026
License
Other

Python

From the README

axross-headless-mcp axross's headless MCP server: file tools on the local disk and on SFTP, SMB, WebDAV, S3 and more for any MCP client, over stdio or HTTP - without Qt. • Your files for any MCP client - Claude Desktop, Claude Code, Cursor, VS Code: list, read, search and hash files. • Almost every file system - the local disk, SFTP built in, and 40 backends from SMB, NFS and S3 to cloud drives, Git and databases as extras. • Read-only by default - the write tools only with --mcp-write and an explicit --mcp-root. • Confined to one folder - every path stays under --mcp-root; SSH and GnuPG keys and tokens are refused. • 50+ tools in groups - metadata, duplicates, archives, crypto, file types, transfers, remote profiles and more. • stdio or HTTP - streamable HTTP with a bearer token, mTLS for anything but loopback. • No GUI, no Qt - runs on a server, in a container or in CI: pipx, uvx or Docker. • Current MCP - 2025-11-25: tool annotations, structured results, progress, cancellation, resources. • An audit trail - what each tool did or refused, on stderr and in the log. • The same code as axross - axross's settings and saved connection profiles, credentials from the keyring. Contents • Everything in detail: the extended README • What changed: the CHANGELOG • What it supports and does • Install • Connect a client • Documentation • Tests • Licence What it supports and does • Almost every file system: the local disk plus 40 backends - protocols, cloud services, devices.…

Read the full README on GitHub →

The most-starred Files & Storage servers in the index, with their live-check result.

ServerStarsLast pushLive check
butterbase-ai MCP3,033Nov 2026Needs sign-in
ProxmoxMCP-Plus661Nov 2026Local / not checked
Directory208Aug 2026Working
Unraid RMCP153Nov 2026Local / not checked
Floodgate106Sep 2026Local / not checked

axross headless MCP: questions people ask

Is axross headless MCP a remote or a local MCP server?
According to its entry in the official MCP registry, axross headless MCP ships as a local package (PyPI, Docker) that your client starts on your machine.
Is axross headless MCP safe to use?
Mostly fine: axross headless MCP is maintained. In detail — maintained: Active; official registry: Active; source: No licence found; runs: On your machine; credentials: None declared. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is axross headless MCP still maintained?
Active: the repository's last commit 2 days ago. Last push Nov 20, 2026, 0 GitHub stars, Other licence. Read from GitHub on Nov 21, 2026.
How do I add axross headless MCP to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. websearchCaptcha-avoiding web, news, image and video search plus page fetching over free sources
Browse all Files & Storage →

Add the badge to your site

Show visitors that axross headless MCP is listed here — it’s also the link we check for a free listing.

axross headless MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-c0decave-axross-headless-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="axross headless MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![axross headless MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-c0decave-axross-headless-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-c0decave-axross-headless-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-c0decave-axross-headless-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-c0decave-axross-headless-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-c0decave-axross-headless-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-c0decave-axross-headless-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-c0decave-axross-headless-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).