What is Mcp Claude

mcp_claude is a cross-platform tool designed to automate the setup of MCP (Model-Claude-Protocol) repositories for integration with Claude Desktop.

Use cases

Use cases include setting up development environments for applications that integrate with Claude Desktop, automating repository configurations, and managing dependencies efficiently.

How to use

To use mcp_claude, clone the repository from GitHub, run the installation script for your operating system, verify the installation, and create a virtual environment to manage dependencies.

Key features

Key features include cross-platform compatibility, automatic installation of required components like Python and Git, and a structured setup process for MCP repositories.

Where to use

mcp_claude can be used in software development environments where Claude Desktop is utilized, particularly for projects that require the Model-Claude-Protocol.

MCP Setup Tool

Una herramienta multiplataforma para automatizar la configuración del entorno de desarrollo para los repositorios MCP (Model-Claude-Protocol) que se integran con Claude Desktop.

📋 Tabla de Contenidos

• Prerrequisitos
• Instalación
• Configuración
• Uso
• Estructura del Proyecto
• Solución de Problemas
• Contribuir

🔧 Prerrequisitos

Requisitos Mínimos del Sistema

Para Windows

• Windows 10 o superior
• PowerShell 5.0 o superior
• Permisos de administrador
• Conexión a Internet

Para macOS

• macOS 10.15 (Catalina) o superior
• Terminal
• Permisos de administrador
• Conexión a Internet

Nota sobre la Instalación Automática

Los siguientes componentes se instalarán automáticamente mediante los scripts de instalación:

• Python 3.8 o superior
• Git
• Homebrew (macOS)
• Command Line Tools (macOS)
• Chocolatey (Windows)

Si ya tienes instalados algunos de estos componentes, los scripts verificarán las versiones y solo actualizarán si es necesario.

🚀 Instalación

1. Clonar el repositorio:

git clone https://github.com/your-org/mcp-setup.git
cd mcp-setup

2. Ejecutar el script de instalación de dependencias según tu sistema operativo:

# Windows (ejecutar PowerShell como administrador)
.\scripts\install_dependencies.ps1

# macOS/Linux
chmod +x ./scripts/install_dependencies.sh
./scripts/install_dependencies.sh

Este paso instalará:

• Python (última versión estable)
• Git
• Homebrew (solo macOS)
• Command Line Tools (solo macOS)
• Chocolatey (solo Windows)

3. Verificar la instalación:

# Verificar Python
python --version  # Windows
python3 --version  # macOS/Linux

# Verificar Git
git --version

4. Crear y activar un entorno virtual:

# Windows
python -m venv venv
.\venv\Scripts\activate

# macOS/Linux
python3 -m venv venv
source venv/bin/activate

5. Instalar dependencias de Python:

pip install -r requirements.txt

Verificación de la Instalación

Después de ejecutar los scripts de instalación, puedes verificar que todo se instaló correctamente:

# Verificar componentes instalados
python --version  # o python3 --version en macOS
git --version
npm --version     # Si se instaló Node.js
pyenv --version   # Si se instaló pyenv
nvm --version     # Si se instaló nvm

# Verificar permisos y rutas
echo $PATH        # En macOS/Linux
echo %PATH%       # En Windows

Si encuentras algún problema, consulta la sección Solución de Problemas.

⚙️ Configuración

1. GitHub Token

Necesitarás un token de acceso personal de GitHub con los siguientes permisos:

• repo (acceso completo)
• read:org

Para generar un token:

1. Ve a GitHub Settings > Developer Settings > Personal Access Tokens
2. Haz clic en “Generate new token”
3. Selecciona los permisos mencionados
4. Copia el token generado

El token puede ser configurado de tres formas:

# 1. Variable de entorno
export GITHUB_TOKEN=your_token_here

# 2. Archivo de configuración
mkdir -p ~/.mcp
echo "your_token_here" > ~/.mcp/github_token

# 3. Interactivamente durante la ejecución del script
# (el script te pedirá el token si no lo encuentra configurado)

2. Configuración de Repositorios

Revisa y ajusta el archivo config/repositories.json según tus necesidades:

3. Variables de Entorno

Prepara las variables de entorno necesarias para cada repositorio. Puedes:

1. Configurarlas en tu sistema
2. Crear un archivo .env en cada repositorio
3. Dejar que el script las solicite interactivamente

📦 Uso

Ejecución Básica

# Windows (como administrador)
python setup.py

# macOS/Linux
python3 setup.py

Proceso de Ejecución

El script realizará las siguientes acciones:

1. Verificación de Prerrequisitos

   • Comprueba versiones de Python y Git
   • Verifica permisos necesarios

2. Configuración de GitHub

   • Valida/solicita token de GitHub
   • Configura credenciales de Git

3. Instalación de Gestores de Paquetes

   • Instala/actualiza nvm (Node.js)
   • Instala/actualiza pyenv (Python)

4. Por cada repositorio:

   • Clona/actualiza el repositorio
   • Instala dependencias
   • Configura variables de entorno
   • Ejecuta pruebas

5. Configuración de Claude Desktop

   • Genera archivo de configuración
   • Lo coloca en la ubicación correcta

Opciones de Ejecución

python setup.py --help  # Muestra opciones disponibles
python setup.py --verbose  # Modo verboso
python setup.py --skip-tests  # Omite ejecución de pruebas

Configurar el repositorio remoto (asumiendo que ya está creado en GitHub)

git remote add origin https://github.com/your-org/mcp-setup.git

git push -u origin develop