Tidymodels MCP Server

Un servidor MCP para acceder a información de tidymodels en GitHub y generar código.

Documentación

Tidymodels MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona herramientas y recursos para trabajar con el ecosistema tidymodels en R.

Resumen

Si bien este servidor MCP es extensible para su uso con flujos de trabajo de IA agnósticos de herramientas, en su forma actual se puede combinar con Cline.bot y Claude Desktop como servidor MCP local. El propósito de este MCP es monitorear el ecosistema tidymodels, específicamente los repositorios de GitHub bajo la organización tidymodels, proporcionando información completa sobre paquetes, funciones y flujos de trabajo comunes de tidymodels.

Actualmente, estoy obteniendo un mejor rendimiento de MCP cuando se combina con Cline para:

  • Listar todos los paquetes del ecosistema tidymodels
  • Proporcionar información detallada sobre paquetes específicos
  • Buscar funciones de R en los paquetes de tidymodels
  • Generar código de plantilla para tareas comunes de tidymodels
  • Buscar problemas en los repositorios de tidymodels

Instalación

Requisitos previos

Preparación

  1. Clona este repositorio:

    git clone https://github.com/yourusername/tidymodels-mcp.git
    cd tidymodels-mcp
    
  2. Instala las dependencias:

    npm install
    
  3. Compila el servidor:

    npm run build
    

Configuración

Token de GitHub (Opcional)

El servidor puede usar un token de GitHub para evitar límites de velocidad al acceder a la API de GitHub. Para proporcionar un token:

  1. Crea un token de acceso personal con el alcance public_repo.
  2. Añádelo a tu configuración como se muestra a continuación.

Añadir a Cline en Visual Studio Code, Positron e IDEs de Código OSS

Después de instalar la extensión de VS Code de Cline, navega a su mercado de Servidores MCP donde puedes configurar los ajustes del servidor MCP local. Luego, añade el JSON a cline_mcp_settings.json de Cline (si deseas aprobar automáticamente las herramientas principales de esta biblioteca de servidores MCP, mantén los nombres que se muestran en la lista autoApprove):

{
  "mcpServers": {
    "tidymodels": {
      "command": "node",
      "args": ["/path/to/tidymodels-mcp/js/index.js"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      },
      "disabled": false,
      "autoApprove": [
        "list_tidymodels_packages",
        "get_package_details",
        "search_r_functions",
        "generate_tidymodels_code",
        "search_issues"
      ]
    }
  }
}

Añadir a Claude Desktop

Para usar este servidor MCP con Claude Desktop, añádelo a tu claude_desktop_config.json:

{
  "mcpServers": {
    "tidymodels": {
      "command": "node",
      "args": ["/path/to/tidymodels-mcp/js/index.js"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

El archivo de configuración normalmente se encuentra en:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Herramientas Disponibles

El servidor proporciona las siguientes herramientas:

list_tidymodels_packages

Lista todos los paquetes del ecosistema tidymodels.

Arguments:
- refresh (optional): Force a refresh of the repository cache

get_package_details

Obtén información detallada sobre un paquete específico de tidymodels.

Arguments:
- package (required): Package name

search_r_functions

Busca funciones de R en los paquetes de tidymodels.

Arguments:
- query (required): Function name or keyword to search for
- package (optional): Limit search to a specific package

generate_tidymodels_code

Genera código de R para tareas comunes de tidymodels.

Arguments:
- task (required): Description of the task
- template (optional): Type of template (recipe, model, tune, evaluation)

search_issues

Busca problemas en los repositorios de tidymodels.

Arguments:
- query (required): Search query
- repo (optional): Limit search to a specific repository
- state (optional): Issue state (open, closed, all)

Recursos Disponibles

El servidor también proporciona acceso a:

  • Todos los repositorios de la organización tidymodels en GitHub
  • Documentación sobre los paquetes de tidymodels
  • Código de plantilla para tareas comunes

Ejemplos de Uso

Aquí hay algunos ejemplos de cómo usar este servidor MCP con Cline:

Listado de Paquetes de Tidymodels

I'd like to know what packages are available in the tidymodels ecosystem.

Obtener Detalles del Paquete

Can you tell me about the parsnip package in tidymodels?

Búsqueda de Funciones

I need to find R functions related to cross-validation in tidymodels.

Generación de Plantillas de Código

Generate code for a tidymodels workflow that predicts housing prices using random forests.

Búsqueda de Problemas

Show me open issues related to recipe preprocessing in tidymodels.

Desarrollo

Estructura del Proyecto

  • js/: Contiene la implementación del servidor en JavaScript/Node.js
  • src/: Contiene el código fuente en TypeScript (si se usa TypeScript)
  • build/: Directorio de salida para los archivos de compilación

Compilación desde el Código Fuente

Si has realizado cambios en los archivos de TypeScript, puedes recompilar el servidor con:

npm run build

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

Agradecimientos