## Local-Files-View-MCP

An MCP server that allows ChatGPT and other AI assistants to access and inspect local files.

## Usage

### Claude Desktop

1. Start the MCP server:

```bash
uv run server.py --root /path/to/sandbox
```

2. Add the following endpoint to Claude Desktop's MCP configuration:

```text
http://127.0.0.1:8000/mcp
```

Set `sandbox root` to the directory you want Claude to be able to access.

### Browser-based ChatGPT and other clients

Start the MCP server using Streamable HTTP:

```bash
uv run server.py --root /path/to/sandbox
```

Once the server is running, connect your MCP client to the following endpoint:

```text
http://127.0.0.1:8000/mcp
```

If you want to use the server with services such as browser-based ChatGPT that cannot directly connect to `localhost`, you will need to expose the HTTP endpoint using a service such as ngrok.

When exposing the server publicly, **make sure that everyone who can connect to the endpoint is trusted to access the files under the sandbox root.**

## Disclaimer

This MCP server is intended for personal use.

If the server is exposed over HTTP, users who can connect to the endpoint may be able to read files under the sandbox root.

Do not expose the endpoint to untrusted users.

Also, do not set the sandbox root to a directory containing sensitive or confidential information.