EC

eyalbenba/claude-code-mcp-init

Developer tools
71 stars 7 forks Quality 50 Trend 14

A lightweight CLI tool to easily configure and initialize MCPs for Claude Code.

Overview

A lightweight CLI for configuring Model Context Protocol (MCP) servers with Claude Code. - 🎨 - Colorful, intuitive menus and status displays - 🔧 - Choose which MCP servers to configure - ✅ - Automatically checks if API keys and dependencies are available - 🚀 - Install and configure everything with simple commands - 🔄 - List, remove, and check status of configured servers - 🔐 - Environment-based API key management The claude-mcp status command shows exactly which environment variables are missing. We welcome contributions! 🎉 Here's how to get started: - 🐛 - Fix issues or improve error handling - ✨ - Add support for more services - 📚 - Improve guides and examples - 🧪 - Help validate configurations - feat/server-name or bugfix/description - Run claude-mcp status and claude-mcp configure - Use existing code style in src/mcp-setup/claude-mcp - Add new servers to README table and .env-mcp.example 4.

README

Claude Code MCP Configuration Manager

⭐ This repo helped you? Consider giving it a star! ⭐

A lightweight CLI for configuring Model Context Protocol (MCP) servers with Claude Code.

Table of Contents

Features

  • 🎨 Beautiful CLI Interface - Colorful, intuitive menus and status displays
  • 🔧 Interactive Configuration - Choose which MCP servers to configure
  • ✅ Requirement Validation - Automatically checks if API keys and dependencies are available
  • 🚀 One-Command Setup - Install and configure everything with simple commands
  • 🔄 Server Management - List, remove, and check status of configured servers
  • 🔐 Secure Configuration - Environment-based API key management

Current Supported MCP Servers

Server Description Requirements
AWS CloudWatch Access AWS logs and metrics AWS_PROFILE, AWS_REGION
Snowflake Query databases with natural language SNOWFLAKE_ACCOUNT, SNOWFLAKE_USER, etc.
Linear Project management integration None (remote server)
GitHub Repository and issue management GITHUB_PAT or GITHUB_TOKEN
Notion Documentation and knowledge base NOTION_API_KEY
Tavily Web search and content extraction TAVILY_API_KEY
Zen Enhanced AI capabilities and workflows OPENAI_API_KEY
MongoDB Database operations MDB_MCP_CONNECTION_STRING
Context7 Up-to-date code documentation for any prompt None (remote server or npm package)
Interrupt User Ask human for context and additional information None (uvx package)

Quick Setup

  1. Clone and install

    git clone https://github.com/Eyalbenba/claude-code-mcp-init
    cd claude-code-mcp-init
    ./src/mcp-setup/install-claude-mcp.sh
    
  2. Configure environment

    cp .env-mcp.example .env-mcp
    # Edit .env-mcp with your API keys
    
  3. Setup MCP servers

    claude-mcp status    # Check requirements
    claude-mcp configure # Interactive setup
    

Commands

Command Description
claude-mcp configure Interactive MCP server configuration
claude-mcp status Check server requirements and status
claude-mcp list List configured MCP servers
claude-mcp remove Remove MCP servers
claude-mcp help Show help information

Troubleshooting

Command not found

# Restart terminal or add to PATH
export PATH="$HOME/.local/bin:$PATH"

Bash version issues (macOS)

brew install bash
/opt/homebrew/bin/bash claude-mcp configure

Missing API keys

The claude-mcp status command shows exactly which environment variables are missing.

Contributing

We welcome contributions! 🎉 Here’s how to get started:

Quick Start: Fork → Clone → Test → Submit PR

🚀 Ways to Contribute

  • 🐛 Bug fixes - Fix issues or improve error handling
  • ✨ New MCP servers - Add support for more services
  • 📚 Documentation - Improve guides and examples
  • 🧪 Testing - Help validate configurations

📋 Contribution Standards

  • Branch naming: feat/server-name or bugfix/description
  • Test your changes: Run claude-mcp status and claude-mcp configure
  • Follow patterns: Use existing code style in src/mcp-setup/claude-mcp
  • Update docs: Add new servers to README table and .env-mcp.example
View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →