Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/runekaagaard/claude-local-files
Serve local files to Claude Desktop via HTTPS.
https://github.com/runekaagaard/claude-local-files
Last synced: 2 days ago
JSON representation
Serve local files to Claude Desktop via HTTPS.
- Host: GitHub
- URL: https://github.com/runekaagaard/claude-local-files
- Owner: runekaagaard
- License: mpl-2.0
- Created: 2024-12-29T11:18:20.000Z (10 days ago)
- Default Branch: main
- Last Pushed: 2024-12-29T11:18:56.000Z (10 days ago)
- Last Synced: 2024-12-29T12:21:55.959Z (10 days ago)
- Size: 8.79 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claude Local Files
Artifacts in Claude Desktop can only access cdn.jsdelivr.net/pyodide/* due to Content Security Policy restrictions. This app bypasses that restriction and allows Claude Desktop artifact and analysis tools to fetch local files and use them for calculations, UI's, etc.
I use it with [mcp-alchemy](https://github.com/runekaagaard/mcp-alchemy/) to have Claude Desktop generate UI reports for database result sets that are way too large for an LLM to read.
## How it works
1. Adds a line in /etc/hosts that points cdn.jsdelivr.net to 127.0.0.1
2. Uses mkcert to generate a valid local SSL certificate for cdn.jsdelivr.net
3. Starts a caddy server that proxies all other requests than to a specfic url folder to Fastly
4. Files in the `./files` directory are served at `https://cdn.jsdelivr.net/pyodide/claude-local-files/[FILENAME]`
4. Removes the line in /etc/hosts on exit
## Installation
### Ubuntu/Debian
```bash
# Install dependencies
sudo apt update
sudo apt install mkcert caddy
```
### macOS
```bash
# Install dependencies
brew install mkcert caddy
```
## Usage
1. Clone and enter the repository:
```bash
git clone https://github.com/runekaagaard/claude-local-files.git
cd claude-local-files
```
2. Start the server:
```bash
./claude-local-files.sh
```
3. Add your files to the `files/` directory
4. Ask Claude Desktop to use the content of the file in a code artifact, e.g. https://cdn.jsdelivr.net/pyodide/claude-local-files/test.json
## Testing
Test that the local server works:
```bash
curl -v https://cdn.jsdelivr.net/pyodide/claude-local-files/test.json
```
Test that CDN passthrough works:
```bash
curl -v https://cdn.jsdelivr.net/npm/jquery/dist/jquery.min.js
```
## Generating URLs
To serve a file:
1. Place it in the `files/` directory
2. Access it at `https://cdn.jsdelivr.net/pyodide/claude-local-files/[FILENAME]`
Example:
- File: `files/test.json`
- URL: `https://cdn.jsdelivr.net/pyodide/claude-local-files/test.json`
## Security Notes
- Only runs locally - the cdn.jsdelivr.net interception is only on your machine
- Uses proper HTTPS with valid certificates via mkcert
- Scripts cleans up /etc/hosts modifications on exit
- Certificates are stored in the git root directory
## Development
Pull requests welcome! Areas for improvement:
- Windows support
- Better logging options
## License
Mozilla Public License 2.0