AI Skills & MCP Config Manager

Simple CLI and web UI tool to manage Model Context Protocol (MCP) configurations and AI skills/rules/commands across multiple AI clients.

Features

• Auto-detection: Automatically discovers supported clients with existing MCP configuration files.
• Multi-client support: Manage configs for a growing list of clients, including Claude, VS Code, Cursor, Windsurf, Gemini, and more. The tool can detect any client that follows the MCP specification.
• Simple CLI: Command-line interface for quick operations
• Web UI: Clean web interface with List, Kanban, and Server views
• MCP Directory: Browse and add popular MCP servers from curated sources (mcpservers.org, awesome-remote-mcp-servers)
• Remote MCP Support: Native HTTP and SSE transport support for remote MCP servers
• Kanban Board: Drag-and-drop servers between clients with rainbow-colored cards and focus mode
• Focus Mode: Click any server to highlight it across all clients with bulk actions
• Config Differentiation: Visual indicators show when same server has different configs across clients
• Auto-Icon Detection: Automatic logo loading via logo.dev API - matches by name, npm package, or domain
• Custom Icon Editing: Click any server icon to customize - search logos, use custom URL, or disable
• Dark Mode: Full dark theme support with properly adapted colors
• JSON Editor: Edit server configs as raw JSON or using forms
• Bulk Operations: Copy servers to multiple clients at once
• Clipboard Support: Quick copy server configs to clipboard
• Cross-platform: Works on macOS, Windows, and Linux
• Import/Export: Share configurations between clients and users
• Environment variables: Easily manage API keys and settings
• Per-Client Skills/Prompts/Rules: Manage AI assistant customizations for 25+ clients
  • Claude Code/Desktop: Skills, Commands, and Agents (~/.claude/skills/, commands/, agents/)
  • Cursor: Rules (~/.cursor/rules/) in MDC format
  • Continue.dev: Prompts (~/.continue/prompts/) and Rules (~/.continue/rules/)
  • Windsurf: Rules (~/.codeium/windsurf/memories/global_rules.md)
  • GitHub Copilot: Instructions and Skills (~/.github/copilot-instructions.md, ~/.copilot/skills/)
  • Amazon Q: Rules (~/.aws/amazonq/rules/)
  • Cline: Rules (~/Documents/Cline/Rules/)
  • Roo Code: Rules (~/.roo/rules/)
  • Gemini CLI: Context, Commands, and Skills (~/.gemini/GEMINI.md, commands/, skills/)
  • Codex: Agents (~/.codex/AGENTS.md) and Skills (~/.codex/skills/)
  • Mistral Vibe: Skills and Agents (~/.vibe/skills/, ~/.vibe/agents/)
  • Amp: Skills (~/.config/agents/skills/)
  • Goose: Skills (~/.config/goose/skills/)
  • OpenCode: Skills (~/.config/opencode/skills/)
  • Firebender: Rules (~/.firebender/rules/)
  • Autohand Code CLI: Skills (~/.autohand/skills/)
  • pi: Skills (~/.pi/agent/skills/)
  • Augment Code: Commands and Rules (~/.augment/commands/, rules/)
  • Aider: Config (~/.aider.conf.yml)
  • And more: JetBrains AI, Tabnine, Piebald, TRAE, Letta, Qodo, VT Code, and others
• Simple & Complex Skills: Single-file skills and directory-based skills with workflows, references
• Tab-Based UI: Each client shows relevant tabs (Servers, Skills, Commands, Rules, Agents, etc.)

Screenshots

List View

Traditional interface with detailed server management, showing individual client configurations with checkboxes for bulk operations.

Kanban View

Drag-and-drop interface displaying servers as cards organized by client, with visual icons for quick actions.

Server View

Consolidated view of all servers showing which clients each server is configured for, with bulk management options.

Remote MCP Setup

Simple interface for adding remote MCP servers - just provide a name and URL to automatically generate the correct configuration.

Installation

# Install globally from npm
npm install -g ai-skills-mcp-config-manager

Alternatively, you can clone the project and run it locally:

# Clone or download the project
cd ai-skills-mcp-config-manager

# Install dependencies
npm install

# Make CLI globally available (optional)
npm link

Usage

CLI Commands

# List all clients and their status
ai-skills-mcp-config-manager list

# Show servers for a specific client
ai-skills-mcp-config-manager show claude

# Add a new server
ai-skills-mcp-config-manager add claude my-server -c npx -a "-y" "@example/server" -e API_KEY=abc123

# Remove a server from one client
ai-skills-mcp-config-manager remove claude my-server

# Remove a server from ALL clients
ai-skills-mcp-config-manager remove all my-server

# Copy server between clients
ai-skills-mcp-config-manager copy claude my-server cursor

# Copy server to ALL other clients
ai-skills-mcp-config-manager copy claude my-server all

# Manage environment variables
ai-skills-mcp-config-manager env claude my-server set API_KEY new-value
ai-skills-mcp-config-manager env claude my-server unset API_KEY
ai-skills-mcp-config-manager env claude my-server list

# Export/Import configurations
ai-skills-mcp-config-manager export claude config.json
ai-skills-mcp-config-manager export claude --server my-server server-config.json
ai-skills-mcp-config-manager import cursor config.json

# Start web UI
ai-skills-mcp-config-manager web
# or
npm run web

Note: Skills and commands management is available through the web UI. Use ai-skills-mcp-config-manager web to access the skills and commands management interface.

Web UI

Start the web server:

# If installed globally
ai-skills-mcp-config-manager web

# If running from cloned repository
npm run web

# Custom port (default is 3456)
PORT=3457 npm run web

Then open http://localhost:3456 in your browser.

The web UI provides:

• Client auto-discovery: Automatically detects clients with existing configurations on startup, with a refresh button to scan for more.
• List View: Traditional interface with detailed server management
  • Multi-select checkboxes for bulk delete operations
  • Remove from all clients button for each server
  • Bulk action toolbar with select all/none options
• Kanban View: Drag-and-drop servers between clients
  • Rainbow-colored cards for visual distinction (adapts to dark mode)
  • Full functionality on cards (edit, copy, export, delete)
  • Drag to copy servers between clients
  • Focus Mode: Click a server card to enter focus mode
    • Highlights the selected server across all clients
    • Other cards go grayscale for clarity
    • Action bar appears with bulk operations: Copy to All, Edit All, Delete from All
    • Press Escape or click outside to exit
  • Config Indicators: Visual badges show config status
    • 🔗 Link icon: Identical config across all clients
    • ⚠️ Warning icon: Config or env vars differ between clients
    • Hover for detailed diff tooltip
  • Auto-Icons: Automatic logo detection for all servers via logo.dev
    • High-quality logos from logo.dev API
    • Matches known services from curated database
    • Extracts service name from npm packages
    • Shows initials when no logo found
  • Custom Icons: Click any icon to customize
    • Search logo.dev by company/domain name
    • Use custom image URL
    • Set to auto-detect or disable icon
• Server View: Consolidated view of all servers across clients
  • Shows which clients each server is configured for
  • Bulk operations to add servers to multiple clients
• MCP Directory: Browse and discover popular MCP servers
  • Curated list from mcpservers.org and awesome-remote-mcp-servers
  • Filter by category, auth type, and search
  • One-click add to multiple clients
  • Shows auth requirements (No Auth, API Key, OAuth)
  • Credits to jaw9c
• Remote MCP Support: Native transport type support for remote MCP servers
  • Choose between HTTP (Streamable HTTP) or SSE (Server-Sent Events) transport
  • Simply provide server name, transport type, and remote URL
  • Generates native type/url configuration (no proxy required)
  • Visual transport type badges (HTTP, SSE, STDIO) in server cards
• JSON Editor: Toggle between form and raw JSON editing
• Multi-select Copy: Copy servers to multiple clients at once
• Clipboard Support: Quick copy server configs with one click
• Config Path Display: See where each client's config file is located
• Dark Mode: Full dark theme support with toggle in header
  • Properly adapted colors for all views
  • Rainbow cards use jewel-tones in dark mode
  • Persists preference in localStorage
• Visual overview of all clients
• Add/edit/delete servers
• Import/export configurations
• Environment variable management
• Per-Client Skills/Rules Mode: Each client shows relevant tabs for its customization types
  • Create, edit, and delete skills, rules, commands, prompts, and more
  • Manage per-client customizations (skills for Claude, rules for Cursor, etc.)
  • View and manage directory-based skill file trees

Skills & Customization Management

The tool includes full support for managing per-client AI assistant customizations alongside MCP server configurations. Each client has its own tabs for managing skills, commands, rules, prompts, or other customization types.

Per-Client Tabs

Different clients support different types of customizations:

| Client | Tabs | |--------|------| | Claude Code/Desktop | Skills, Commands, Agents | | Cursor | Rules (MDC format) | | Continue.dev | Prompts, Rules | | Windsurf | Rules | | GitHub Copilot | Instructions, Skills | | Amazon Q | Rules | | Cline | Rules | | Roo Code | Rules | | Gemini CLI | Context, Commands, Skills | | Codex | Agents, Skills | | Mistral Vibe | Skills, Agents | | Amp (Sourcegraph) | Skills | | Goose (Block) | Skills | | OpenCode | Skills | | Firebender | Rules (MDC format) | | Autohand Code CLI | Skills | | pi | Skills | | Piebald | Skills, Agents | | JetBrains AI | Rules | | Augment Code | Commands, Rules | | Tabnine | Guidelines | | Aider | Config |

Using the Web UI

1. Select a client: Each client card shows its available tabs (Servers, Skills, Commands, Rules, etc.)
2. Switch tabs: Click a tab to view and manage that type of content
3. Create new items: Click "Add" to create new skills, rules, commands, etc.
4. Edit existing: Click on any item card to edit its content
5. Manage files: For complex/directory-based skills, view and manage associated file trees
6. Copy items: Duplicate items within the same tab

Skill File Structure (Claude Code)

---
name: my-skill
description: A helpful skill description
---

# My Skill

Instructions and content for the skill...

Supported Clients

This tool supports auto-detection of any client that follows the Model Context Protocol specification. The following is a non-exhaustive list of clients that have been tested and are known to work:

• Aider: Config management (~/.aider.conf.yml)
• Agentman: Registered (no confirmed global paths)
• Amazon Q Developer: ~/.aws/amazonq/mcp.json
• Amp (Sourcegraph): Skills (~/.config/agents/skills/)
• Augment Code: Commands (~/.augment/commands/) and Rules (~/.augment/rules/)
• Autohand Code CLI: Skills (~/.autohand/skills/)
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Code: ~/.claude.json (global settings and MCP servers)
• Cline: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Codex: ~/.codex/config.toml (TOML with [mcp_servers.<name>] tables)
• Command Code: Registered (no confirmed global paths)
• Cursor: .cursor/mcp.json (project-specific) or ~/.cursor/mcp.json (global)
• Databricks: Workspace-level skills support
• Factory Bridge: ~/Library/Application Support/Factory Bridge/mcp.json
• Firebender: Rules (~/.firebender/rules/*.mdc)
• Gemini: ~/.gemini/settings.json
• Google AntiGravity: ~/.gemini/antigravity/mcp_config.json
• Goose (Block): Skills (~/.config/goose/skills/)
• JetBrains AI Assistant: ~/.aiassistant/rules/ (rules management)
• Letta Code: Project-level skills support
• Mistral Vibe: Skills (~/.vibe/skills/) and Agents (~/.vibe/agents/)
• Mux: Registered (no confirmed global paths)
• Ona: Cloud-based AI software engineers
• OpenCode: Skills (~/.config/opencode/skills/)
• pi: Skills (~/.pi/agent/skills/)
• Piebald: Uses Claude Code paths (desktop app wrapper)
• Qodo: Registered (TOML-based agent configs)
• Roo Code: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• Spring AI: Library-level skills integration
• Tabnine: ~/.tabnine/guidelines/ (guidelines management)
• TRAE (ByteDance): Project-level rules support
• VS Code: .vscode/mcp.json
• VT Code: Follows Agent Skills standard
• Windsurf: ~/.codeium/windsurf/mcp_config.json or ~/AppData/Roaming/WindSurf/mcp_settings.json (Windows)
• Zed AI: Project-root .rules file for per-project configuration

Note: Paths may vary based on your operating system. The tool will attempt to find the correct path automatically.

Configuration Format

Local MCP Servers (stdio transport)

Standard MCP server configuration for local processes (JSON-based clients like Claude Desktop, Claude Code, Cursor, VS Code, etc.):

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

Remote MCP Servers (HTTP/SSE transport)

Native remote server configuration using HTTP (Streamable HTTP) or SSE (Server-Sent Events) transport:

{
  "mcpServers": {
    "remote-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    },
    "sse-server": {
      "type": "sse",
      "url": "https://example.com/sse"
    }
  }
}

Codex uses a TOML configuration file at ~/.codex/config.toml, where MCP servers are defined under the [mcp_servers.<server-name>] tables. For example:

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"

API Reference

The web UI communicates with the server via REST API endpoints. These can also be used for automation and integration.

MCP Server Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /api/clients | List all detected clients | | GET | /api/clients/:client/servers | List servers for a client | | POST | /api/clients/:client/servers/:server | Create a server | | PUT | /api/clients/:client/servers/:server | Update a server | | DELETE | /api/clients/:client/servers/:server | Delete a server | | POST | /api/clients/:client/servers/:server/copy | Copy server to other clients | | POST | /api/clients/:client/import | Import configuration | | GET | /api/clients/:client/export | Export configuration |

Per-Client Skills/Prompts/Rules Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /api/clients/:client/tabs | List skill tabs for client | | GET | /api/clients/:client/has-skills | Check if client supports skills | | GET | /api/clients/:client/tabs/:tab/items | List items in tab | | GET | /api/clients/:client/tabs/:tab/items/:name | Read item | | POST | /api/clients/:client/tabs/:tab/items/:name | Create item | | PUT | /api/clients/:client/tabs/:tab/items/:name | Update item | | DELETE | /api/clients/:client/tabs/:tab/items/:name | Delete item | | GET | /api/clients/:client/tabs/:tab/items/:name/files | List files in complex item | | GET | /api/clients/:client/tabs/:tab/items/:name/files/*path | Read file | | PUT | /api/clients/:client/tabs/:tab/items/:name/files/*path | Write file | | POST | /api/clients/:client/tabs/:tab/items/:name/copy | Copy item |

Commands Endpoints

| Method | Endpoint | Description | |--------|----------|-------------| | GET | /api/commands | List all commands | | GET | /api/commands/:name | Read command | | POST | /api/commands/:name | Create command | | PUT | /api/commands/:name | Update command | | DELETE | /api/commands/:name | Delete command | | POST | /api/commands/:name/rename | Rename command | | POST | /api/commands/:name/duplicate | Duplicate command |

Security Note

Environment variables may contain sensitive data like API keys. The tool masks values containing "KEY" or "SECRET" in the display but stores them in plain text in config files.

Development & Testing

Development Workflow

Complete workflow for changes:

# 1. Make your changes to the code

# 2. Run tests to verify everything works
npm test

# 3. Update README.md with any new features or changes

# 4. Commit changes
git add .
git commit -m "feat: Your feature description

- Detailed changes
- Tests: 17/17 CLI ✅, 2/2 UI ✅

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>"

# 5. Push to repository
git push

# 6. Publish to npm (maintainers only)
npm version patch  # or minor/major
npm publish

Running Tests

The project includes comprehensive test coverage:

# Run all tests (CLI + UI)
npm test

# Run CLI tests only (17 tests)
npm run test:cli

# Run UI tests only (2 tests) - requires Playwright
npm run test:ui

# Run specific test file
npx mocha test/ui-simple.test.js --timeout 30000

Test Coverage

• CLI Tests: 17/17 ✅ - Comprehensive command-line functionality testing
• UI Tests: 2/2 ✅ - Frontend integration and API communication testing
• Kanban Tests: 4/4 ✅ - Drag-and-drop and copy functionality
• Config Comparison Tests: 11/11 ✅ - Server config differentiation logic
• Integration Tests: End-to-end dual-mode form/JSON editing validation

Development Setup

# Install dependencies (includes Playwright for UI testing)
npm install

# Install Playwright browsers (for UI tests)
npx playwright install chromium

# Start development server with mock data
MCP_USE_MOCK_CLIENTS=true npm run web

# Run server on custom port
PORT=3457 npm run web

Testing with Mock Clients

For development and testing, you can use mock clients:

# Enable mock client mode
export MCP_USE_MOCK_CLIENTS=true

# Start server (will use test clients instead of real ones)
npm run web

This allows testing functionality without affecting real MCP client configurations.

What's New in v2.3.4

CLI Version Auto-Sync

• Fixed CLI --version was hardcoded at 2.3.1 while package.json was at 2.3.3
• CLI now reads version dynamically from package.json so it can never drift again

What's New in v2.3.1

Package Rename: ai-skills-mcp-config-manager

• Renamed from mcp-config-manager to ai-skills-mcp-config-manager to reflect skills management as a first-class feature
• Old CLI aliases (mcp-config-manager, mcp-manager) have been removed
• Updated description, keywords, and branding across the project
• Synced CLI --version output to match package version

What's New in v2.3.0

20 New Clients with Skills Support

• Firebender: Rules in MDC format (~/.firebender/rules/)
• Goose (Block): Skills (~/.config/goose/skills/)
• Amp (Sourcegraph): Skills (~/.config/agents/skills/)
• OpenCode: Skills (~/.config/opencode/skills/)
• Mistral Vibe: Skills and Agents (~/.vibe/skills/, ~/.vibe/agents/)
• pi: Skills (~/.pi/agent/skills/)
• Autohand Code CLI: Skills (~/.autohand/skills/)
• Piebald: Uses Claude Code paths
• TRAE, Letta, Qodo, VT Code, Command Code, Ona, Agentman, Mux, Spring AI, Databricks: Registered with placeholder support

New Tabs for Existing Clients

• Claude Code/Desktop: Added Agents tab (~/.claude/agents/)
• Gemini CLI/AntiGravity: Added Skills tab (~/.gemini/skills/)
• GitHub Copilot: Added Skills tab (~/.copilot/skills/)
• Augment Code: Added Commands tab (~/.augment/commands/)
• Aider: Added Config tab (~/.aider.conf.yml)

UI Improvements

• Widened Edit Skill modal from 900px to 1200px for better file tree + editor layout
• Fixed dead CSS selector for skill modal content

Total: 38 clients registered, 25 with active skills/rules support

What's New in v2.2.0

Per-Client Skills/Prompts/Rules Management

• Per-client architecture: Each client now has its own skills, prompts, rules, or commands tabs based on what it supports
• Tab-based UI: Client cards show relevant tabs (Servers, Skills, Commands, Rules, etc.) depending on the client
• Complex skills: Full support for directory-based skills with file trees and multiple associated files
• New API endpoints: Complete REST API for per-client tab items and file management

Security Hardening

• Input validation and path traversal protection for skills/rules file operations
• Sanitized file names and directory paths

CSS Fixes

• Improved dark mode styling for skills/rules tabs
• Fixed tab layout and spacing across views

What's New in v2.1.1

Bug Fix

• Codex format delete fix: Server deletion now works correctly for Codex TOML configs (previously deleted servers would reappear due to incorrect object spread in denormalizeConfig)

What's New in v2.1.0

Custom Icon Editing

Click any server icon to customize it:

• Search logos by company name or domain via logo.dev API
• Custom URL support for any image
• Auto-detect option uses smart matching
• No icon option shows initials only
• Preferences saved in localStorage

Improved Logo Quality

• Upgraded to logo.dev API for high-quality company logos
• Better service name extraction from npm packages
• Smarter domain matching with skip list for ambiguous names

UI Improvements

• Icons properly aligned with server names
• Copy button moved to header actions (cleaner card layout)
• Simplified icon editor UI in modals

What's New in v2.0.0

MCP Directory

Browse and add popular MCP servers from curated sources without manual configuration:

• 50+ servers from mcpservers.org and awesome-remote-mcp-servers
• Filter by category: Development, Productivity, Data, Communication, etc.
• Filter by auth type: No Auth, API Key, OAuth
• One-click install to multiple clients

Auto-Icon Detection

All servers now automatically display logos:

• Matches from curated logo database (GitHub, Slack, Notion, etc.)
• Extracts service names from npm packages (@modelcontextprotocol/server-github → GitHub logo)
• High-quality logos via logo.dev API
• Shows initials when no logo found

Dark Mode Improvements

• Rainbow-colored Kanban cards now use jewel-tones in dark mode
• Proper text contrast on all colored backgrounds
• Full theme support across all views and modals

Bug Fixes

• Fixed server deletion in Server View (was prompting twice but not deleting)
• Improved event handling reliability
• Fixed Codex format delete bug: Server deletion now works correctly for Codex TOML configs (previously deleted servers would reappear)

License

MIT