Below are the complete, step-by-step instructions you can drop directly into your project's README.md or share with your users.

Since your server must read and write local files, the Deno configuration includes the necessary security permissions to allow local file access.

Installing & Configuring fdx-mcp-server

Because fdx-mcp-server is built using modern TypeScript, you can run it securely and instantly on your local machine using Bun or Deno without needing any compilation or dealing with OS code-signing warnings.

Choose one of the setup paths below depending on your preferred runtime environment.

Path A: The Bun Setup (Recommended & Fastest)

Bun offers the fastest startup speeds. If you have Bun installed, you can execute the server directly from GitHub without installing it globally.

1. The .mcp.json Configuration

Add the following configuration block to your MCP client configuration file (e.g., claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "fdx-mcp-server": {
      "command": "bun",
      "args": [
        "run",
        "https://raw.githubusercontent.com/dmongrel/fdx-mcp-server/main/index.ts"
      ]
    }
  }
}

• How it works: Bun will automatically download, cache, and execute the server file on startup. It runs natively with access to your local filesystem.

Related MCP server: Local Files MCP Server

Path B: The Deno Setup (Secure & Sandboxed)

Deno runs in a secure-by-default sandbox. Because fdx-mcp-server needs to read and write local files, you must explicitly grant it those permissions using flags.

1. The .mcp.json Configuration

Add the following configuration block to your MCP client configuration file:

{
  "mcpServers": {
    "fdx-mcp-server": {
      "command": "deno",
      "args": [
        "run",
        "--allow-read",
        "--allow-write",
        "--allow-net",
        "https://raw.githubusercontent.com/dmongrel/fdx-mcp-server/main/index.ts"
      ]
    }
  }
}

• --allow-read & --allow-write: Required to allow the server to interact with your local files.

• --allow-net: Required to let Deno resolve external package dependencies.

Path C: Global NPM Installation (No Bun or Deno Required)

If you prefer a traditional Node.js/NPM setup, you can install the package globally directly from GitHub. This downloads all dependencies locally so the server can boot instantly and work 100% offline.

1. Install Globally via NPM

Run the following command in your terminal:

npm install -g github:dmongrel/fdx-mcp-server

2. The .mcp.json Configuration

Once installed, add this block to your configuration file:

{
  "mcpServers": {
    "fdx-mcp-server": {
      "command": "fdx-mcp-server",
      "args": []
    }
  }
}

• To Update Later: If updates are pushed to GitHub, you can pull the latest changes anytime by running:

npm update -g fdx-mcp-server