# MCP JARVIS Configuration Tool

<p align="center">
  <img src="https://www.mcpjarvis.com/favicon.svg" alt="MCP JARVIS Logo" width="120" height="120"/>
</p>

A one-line installation tool for setting up MCP servers with Claude Desktop. This tool allows you to easily configure Claude Desktop with various MCP servers, simplifying the installation process and API key management.

## What is MCP JARVIS?

MCP JARVIS enables Claude Desktop to work with various server-based tools and capabilities. With this configuration tool, you can:

- Set up essential MCP servers for Claude Desktop in one command
- Distribute custom server configurations to other users
- Add any compatible MCP server to Claude Desktop with minimal effort

### What are MCP servers?

MCP servers enable the Claude Desktop assistant to use custom tools such as web search, file editing and YouTube transcript downloads. They also allow the AI assistant to interact with other applications - publishing articles on WordPress blogs, connecting to company databases or CRM systems, generating reports, and creating new entries.

### Included MCP Servers

The default installation includes the following MCP servers:

#### Filesystem Operations
Complete file and directory management within specified directories. Create, edit, move, and search files with advanced pattern matching.

#### Brave Search Integration
Comprehensive web search capabilities including local business search. Get fresh and relevant content with smart filtering.

#### Markdown Downloader
Capture and store web page content in markdown format. Perfect for content creation and research.

#### YouTube Transcript
Extract and analyze video transcripts (up to 45-minute videos in server version). Ideal for content analysis and summarization.

## Installation

### Prerequisites
- Make sure you have [Node.js](https://nodejs.org/) installed on your system
- If you want search capabilities, get a [Brave Search API key](https://brave.com/search/api/) (up to 2,000 free queries/month)
- [Claude Desktop](https://claude.ai/download) should be installed

### macOS Installation

1. Open Terminal application on your Mac
2. Paste & run the installation command:

```bash
npm install -g mcp-jarvis-config && mcp-jarvis-config
```

3. Follow the on-screen instructions:
   - Select your Downloads folder using a native dialog
   - Enter your Brave Search API key if prompted
   - After installation, restart Claude Desktop for changes to take effect

### Windows Installation

1. Open Command Prompt (cmd) application
2. Paste & run the installation command:

```
npm install -g mcp-jarvis-config && mcp-jarvis-config-windows
```

3. Follow the on-screen instructions:
   - Use native Windows dialogs to select your Downloads folder
   - Enter your Brave Search API key if prompted
   - After installation, restart Claude Desktop for changes to take effect

## Usage

### Basic Usage

The installation commands above will set up the default MCP servers. The process is guided and requires minimal input.

### Using a Custom Configuration

You can use a custom configuration created on the MCP JARVIS website:

#### macOS
```bash
mcp-jarvis-config --config-url https://www.mcpjarvis.com/api/config/YOUR_CONFIG_ID
```

#### Windows
```
mcp-jarvis-config-windows --config-url https://www.mcpjarvis.com/api/config/YOUR_CONFIG_ID
```

## Creating Custom Configurations

Visit [www.mcpjarvis.com/config-generator](https://www.mcpjarvis.com/config-generator) to create custom configurations:

1. Choose which MCP servers to include
2. Add your own custom MCP servers as needed
3. Generate a unique installation command to share with others

## Features

- One-line installation for MCP servers
- Dynamic placeholder detection and API key prompting
- Web-based configuration generator for custom setups
- Supports adding any compatible MCP server
- Automatically configures Claude Desktop
- Creates backups of existing configurations

## System Requirements

- Node.js 16.0.0 or higher
- Claude Desktop installed
- Operating System: macOS or Windows

## Placeholders

The tool automatically detects placeholder values in the format `{{PLACEHOLDER}}` and prompts the user to enter values for them. Common placeholders include:

- `{{BRAVE_API_KEY}}` - API key for the Brave Search server
- `{{FIRE_CRAWL_API_KEY}}` - API key for the FireCrawl server
- `{{DOWNLOADS_FOLDER}}` - Path to the user's downloads folder
- Any other API keys or values marked with the `{{PLACEHOLDER}}` format

## Finding Additional MCP Servers

You can search for compatible MCP servers through the [MCP JARVIS website](https://www.mcpjarvis.com/search) or via the Pulse MCP REST API. Found servers can be:

- Added directly to your configuration
- Viewed for more details including GitHub repository
- Verified for proper configuration syntax

## License

MIT