open-index/open-npm huggingface dataset:
npm package: @fanlyapp/cli
Description: A NPX command to install and list Model Context Protocols from Fanly
Latest version: 0.9.8

# Fanly MCP CLI

The Fanly MCP registry installer and manager for Model Context Protocol (MCP) servers, designed to be client-agnostic.

## Requirements
- NodeJS version 18 or above

## Usage

```bash
npx @fanly/cli <command>
```

### Available Commands

- `install <package>` - Install a package
  - `--client <name>` - Specify the AI client
  - `--config <json>` - Provide configuration data as JSON (skips prompts)
- `uninstall <package>` - Uninstall a package
  - `--client <name>` - Specify the AI client
- `inspect <server-id>` - Inspect a server interactively
- `run <server-id>` - Run a server
  - `--config <json>` - Provide configuration for the server
- `list clients` - List available clients
- `--help` - Show help message
- `--verbose` - Show detailed logs for debugging

### Examples

```bash
# Install a server (requires --client flag)
npx @fanly/cli install mcp-obsidian --client claude

# Install a server with pre-configured data (skips prompts)
npx @fanly/cli install mcp-obsidian --client claude --config '{"vaultPath":"path/to/vault"}'

# Remove a server
npx @fanly/cli uninstall mcp-obsidian --client claude

# List available clients
npx @fanly/cli list clients

# Inspect a specific server from fanly's registry
npx @fanly/cli inspect mcp-obsidian

# Run a server with configuration
npx @fanly/cli run mcp-obsidian --config '"{\\"key\\":\\"value\\"}"'

# Show help menu
npx @fanly/cli --help

# Install with verbose logging for debugging
npx @fanly/cli install mcp-obsidian --client claude --verbose
```

### Important Notes

- Remember to restart your AI client after installing or uninstalling servers
- Use the `inspect` command for interactive server testing
- Run without arguments to see the help menu
- Use `--verbose` flag for detailed logs when troubleshooting

## Development

This guide will help you get started with developing for @fanly/cli.

### Getting Started

1. Clone the repository:
   ```bash
   git clone https://github.com/fanly-ai/cli
   cd cli
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Build the project:
   ```bash
   npm run build
   ```

### Development Commands

```bash
# List all servers
npx . <command>

# Inspect a specific server
npx . inspect <server-id>

# Install a server
npx . install <server-name> --client <client-name>

# Run with verbose logging
npx . <command> --verbose
```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.