npm package: @seanpoyner/claude-desktop-mcp-playground-node
Description: Node.js CLI tool for managing Claude Desktop's Model Context Protocol (MCP) servers
Author: Claude MCP Node Contributors
Latest version: 0.1.0

# Claude MCP Node

A Node.js CLI tool for managing Claude Desktop's Model Context Protocol (MCP) servers. This is a sister project to the Python version, providing the same functionality with a Node.js implementation.

## Features

- **Server Registry**: Comprehensive database of 30+ MCP servers with installation details
- **CLI Interface**: User-friendly command-line tool (`pg`) for server management  
- **Interactive Setup**: Guided wizard for easy server installation and configuration
- **Configuration Management**: Direct integration with Claude Desktop configuration files
- **Cross-Platform**: Full support for macOS, Windows, and Linux

## Installation

### Prerequisites
- Node.js 18+ required

### Install Dependencies
```bash
npm install
```

### Make CLI Available Globally
```bash
npm link
```

Or install dependencies and run directly:
```bash
npm start
```

## Usage

### Interactive Setup Wizard
```bash
pg setup                    # Interactive setup wizard
pg setup --quick           # Quick setup with popular servers
```

### Server Management
```bash
pg config search <query>    # Search MCP servers
pg config info <server_id>  # Get server details  
pg config install <server_id>  # Install a server
pg config list             # List installed servers
pg config show             # Show current configuration
```

### Configuration Management
```bash
pg config add <name> <command> [--args] [--env]  # Add custom server
pg config remove <name>     # Remove a server
pg config import           # Import current Claude Desktop config
```

## Available MCP Servers

### Official Servers (15)
- **filesystem** - Secure file operations with configurable access controls
- **memory** - Knowledge graph-based persistent memory system
- **puppeteer** - Browser automation and web scraping
- **github** - Access GitHub repositories, issues, and PRs
- **sqlite** - Query and manage SQLite databases
- **postgres** - Connect to PostgreSQL databases
- **fetch** - Web content fetching and conversion
- **brave-search** - Web search with privacy focus
- And more...

### Community Servers (19)
- **linear** - Manage Linear issues and projects
- **figma** - Access Figma design files
- **aws-third-party** - AWS services integration
- **azure** - Microsoft Azure services
- **elasticsearch** - Query Elasticsearch with natural language
- And more...

## Configuration File Locations

The tool manages Claude Desktop's MCP server configuration:

- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`  
- **Linux**: `~/.config/Claude/claude_desktop_config.json`

## Development

### Project Structure
```
claude-mcp-node/
├── src/
│   ├── cli.js              # Main CLI interface
│   ├── serverRegistry.js   # MCP server database
│   ├── configManager.js    # Configuration file management
│   ├── setupWizard.js      # Interactive setup
│   └── index.js           # Entry point
├── bin/
│   └── pg.js              # CLI executable
├── test/                  # Test files
└── package.json
```

### Scripts
```bash
npm start          # Run the CLI
npm run dev        # Run with file watching
npm test           # Run tests
npm run lint       # Run ESLint
npm run format     # Format code with Prettier
```

### Dependencies
- **commander** - CLI framework
- **chalk** - Terminal colors and styling
- **inquirer** - Interactive prompts
- **ora** - Loading spinners
- **boxen** - Terminal boxes
- **fs-extra** - Enhanced file system operations

## Examples

### Quick Setup
```bash
# Install essential servers quickly
pg setup --quick
```

### Browse and Install Servers
```bash
# Search for GitHub-related servers
pg config search github

# Get detailed info about a server
pg config info github

# Install with custom configuration
pg config install github --env GITHUB_TOKEN=your_token_here
```

### Manual Server Configuration
```bash
# Add a custom server
pg config add my-server npx --args my-package --env API_KEY=secret

# List all configured servers
pg config list

# Remove a server
pg config remove my-server
```

## Comparison with Python Version

This Node.js implementation provides the same core functionality as the Python version:

| Feature | Python Version | Node.js Version |
|---------|----------------|-----------------|
| CLI Framework | Click | Commander.js |
| Interactive Prompts | Click prompts | Inquirer.js |
| Terminal Styling | Rich/Click | Chalk + Boxen |
| File Operations | pathlib/json | fs-extra |
| Configuration Management | ✅ | ✅ |
| Server Registry | ✅ | ✅ |
| Setup Wizard | ✅ | ✅ |
| Cross-platform | ✅ | ✅ |

## Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Run linting and formatting
6. Submit a pull request

## License

MIT License - see LICENSE file for details.

## Related Projects

- [Python Version](../README.md) - Original Python implementation
- [Claude Desktop](https://claude.ai) - The Claude Desktop application
- [MCP Servers](https://github.com/modelcontextprotocol/servers) - Official MCP servers repository