claude-code-mcp-init

Step-by-Step Guide

1. Define the server in src/mcp-setup/claude-mcp:

   MCP_SERVERS[newserver]="New Server Name"
   MCP_DESCRIPTIONS[newserver]="Description of what this server does"
   MCP_REQUIREMENTS[newserver]="REQUIRED_ENV_VAR, ANOTHER_VAR"
   

2. Add configuration function:

   configure_newserver_server() {
       if claude mcp add "server-name" "$UVX_PATH" \
           server-package@latest \
           -e "ENV_VAR=$ENV_VAR" \
           -t stdio; then
           print_success "New Server configured successfully"
       else
           print_error "Failed to configure New Server"
           return 1
       fi
   }
   

3. Wire it up in the case statement:

   case "$server_key" in
       # ... existing servers ...
       "newserver")
           configure_newserver_server
           ;;
   

4. Update documentation:

   • Add server to the Supported MCP Servers table above
   • Add environment variables to .env-mcp.example

5. Test thoroughly:

   claude-mcp status    # Should show your new server
   claude-mcp configure # Should allow configuring it
   

Quick Setup

# Fork the repo on GitHub, then:
git clone https://github.com/YOUR-USERNAME/claude-mcp-init
cd claude-mcp-init
./src/mcp-setup/install-claude-mcp.sh

# Create test environment
cp .env-mcp.example .env-mcp
# Edit .env-mcp with your test credentials

# Test your changes
claude-mcp status
claude-mcp configure

Requirements

• Bash 4.0+ (auto-installed on macOS via Homebrew)
• uvx (auto-detected or set UVX_PATH_OVERRIDE)
• Claude Code CLI

Before Submitting

• Tested locally - Your changes work with claude-mcp status and claude-mcp configure
• Documentation updated - README table and .env-mcp.example if adding new server
• Code follows patterns - Matches existing style and structure
• Branch named correctly - feat/server-name or bugfix/description
• Clear commit message - Explains what and why

Pull Request Template

## Changes
- Brief description of what you added/fixed

## Testing
- [ ] Tested with `claude-mcp status`
- [ ] Tested with `claude-mcp configure`
- [ ] Updated documentation if needed

## Type of Change
- [ ] Bug fix
- [ ] New MCP server
- [ ] Documentation update
- [ ] Other: ___________

Code of Conduct

• Be respectful and inclusive in all interactions
• Help others learn and contribute
• Focus on constructive feedback in reviews
• Assume good intentions from contributors

Getting Help

• Issues - Use GitHub Issues for bugs and feature requests
• Discussions - Use GitHub Discussions for questions
• Security - Email security issues privately (see Security section)

Recognition

All contributors will be recognized in our release notes and contributor acknowledgments.