File Opener MCP Server

A Model Context Protocol (MCP) server that provides file opening capabilities for Claude AI.

Features

• open_file: Open any file or directory with the system's default application

• reveal_in_finder: Reveal a file or directory in macOS Finder

• Optional application specification (e.g., open with Preview, TextEdit, etc.)

• Cross-platform support (primarily macOS focused)

• Full error handling and validation

Installation

Quick Install

From Source

1. Clone the repository:

   git clone https://github.com/TIMBOTGPT/file-opener-mcp.git cd file-opener-mcp

2. Install dependencies:

   npm install

3. Test the server:

   npm start

Usage with Claude Desktop

Add this server to your Claude Desktop MCP configuration (claude_desktop_config.json):

Or if installed locally:

Available Tools

open_file

Opens a file or directory with the system's default application, or optionally with a specified application.

Parameters:

• path (required): Full path to the file or directory

• application (optional): Specific application to use (e.g., "Preview", "TextEdit")

Example:

reveal_in_finder

Reveals a file or directory in macOS Finder.

Parameters:

• path (required): Full path to the file or directory

Example:

Requirements

• macOS (uses open command)

• Node.js 16+

• Claude Desktop with MCP support

Security

• File existence is validated before opening

• Only executes safe system open commands

• Proper error handling and reporting

• No network access required

License

MIT License - see LICENSE file for details

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests if applicable

5. Submit a pull request

Support

For issues and questions, please use the GitHub Issues page.