axross headless MCP
● Activeio.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.
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"
]
}
}
}claude mcp add axross-headless-mcp -- uvx axross-headless-mcpcodex mcp add axross-headless-mcp -- uvx axross-headless-mcpcode --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
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Mostly 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 →Alternatives to axross headless MCP
All axross headless MCP alternatives →Best Files & Storage servers →The most-starred Files & Storage servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| butterbase-ai MCP | 3,033 | Nov 2026 | Needs sign-in |
| ProxmoxMCP-Plus | 661 | Nov 2026 | Local / not checked |
| Directory | 208 | Aug 2026 | Working |
| Unraid RMCP | 153 | Nov 2026 | Local / not checked |
| Floodgate | 106 | Sep 2026 | Local / 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.
More from c0decave
All 2 servers by c0decave →More Files & Storage servers
Browse all Files & Storage →Holo Folder
Cal-Morris
Pokémon TCG binders, collection, wanted list, card catalogue and GBP prices. OAuth, Premium plan.
CanvasKeep
CanvasKeep
Create and edit Excalidraw diagrams in your CanvasKeep workspace, with auto-layout and folders.
TrueNAS SCALE
cedricziel
Inspect and manage TrueNAS SCALE storage, shares, apps and system state with your own API key
dfwmetro.net directory
cexplayer01
Verified DFW home-services directory. AI agents submit listings and find bookable pros.
KaiBoard MCP
ChasenKai
Let AI agents draw on your local-first KaiBoard whiteboards (relay or local folder).
Synology NAS
cmeans
MCP server for Synology NAS — browse files, monitor health, and automate operations
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.
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
[](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.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-c0decave-axross-headless-mcp) [](https://serverdex.io/install/vscode/io-github-c0decave-axross-headless-mcp) [](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).