MCP Server Manager for Claude

Install and manage Model Context Protocol (MCP) servers for Claude Desktop.

Command-line tool for managing MCP servers in Claude Code. Supports user and project-level server installation and configuration.

# Create configuration from template cp mcp-servers.json.example mcp-servers.json # Add servers to user scope make add SERVERS=memory,brave-search # Sync all configured servers make sync # List installed servers make list

- Claude CLI installed (npm install -g @anthropic-ai/claude-code)
- Python 3.8+ with Ansible (pip install ansible)
- Node.js 18+ (for Claude CLI)
- Clone this repository
- Install Ansible:pip install ansible
- Verify Claude CLI:claude --version

# Add specific servers make add SERVERS=memory,github # Remove servers make remove SERVERS=memory # List all servers make list # Sync from configuration file make sync

# Add servers to current project make project-add SERVERS=github # List project servers make project-list # Sync project servers make project-sync

# Configure servers on remote host make sync-remote SSH_HOST=192.168.1.100 SSH_USER=ubuntu # Add servers to remote Claude CLI make add-remote SERVERS=memory SSH_HOST=server.example.com SSH_USER=admin

Editmcp-servers.jsonto define available servers:

{ "memory": { "command": "npx", "args": ["-y", "@anthropic-ai/mcp-server-memory"], "env": {} }, "github": { "command": "npx", "args": ["-y", "@anthropic-ai/mcp-server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}" } } }

Create.envfile for API keys and secrets:

GITHUB_TOKEN=ghp_your_token_here BRAVE_API_KEY=your_brave_key_here

Variables in server configurations use${VAR_NAME}syntax for substitution.

For complex scenarios, use Ansible directly:

# Custom configuration file ansible-playbook ansible/manage-mcp.yml -e "config_file=my-config.json" # Specific operation with custom parameters ansible-playbook ansible/manage-mcp.yml \ -e "mode=individual" \ -e "operation_mode=add" \ -e "servers=memory,github"

Seedocs/ADVANCED.mdfor complete Ansible documentation.

- mcp-servers.json- Server definitions and configurations
- .env- Environment variables and API keys (optional)
- ansible/group_vars/all.yml- Default Ansible variables

Seeansible/examples/for sample configurations:

- mcp-servers.json- Example server definitions
- secrets.yml.example- Environment variable template

- Advanced Usage- Direct Ansible usage
- Configuration Guide- Detailed configuration options
- Contributing- Development guidelines

Score CLAUDE.md/AGENTS.md, validate clarx-manifest.json, generate CI workflows, and pull repo scan findings into Cursor, Claude, or Grok.