Tidymodels MCP Server

Um servidor MCP para acessar informações do tidymodels no GitHub e gerar código.

Documentação

Servidor MCP Tidymodels

Um servidor Model Context Protocol (MCP) que fornece ferramentas e recursos para trabalhar com o ecossistema tidymodels em R.

Visão Geral

Embora este servidor MCP seja extensível para uso com fluxos de trabalho de IA agênticos agnósticos de ferramentas, em sua forma atual ele pode ser emparelhado com Cline.bot e Claude Desktop como um servidor MCP local. O objetivo deste MCP é monitorar o ecossistema tidymodels, especificamente os repositórios do GitHub sob a organização tidymodels, fornecendo informações abrangentes sobre pacotes, funções e fluxos de trabalho comuns do tidymodels.

Atualmente, estou obtendo melhor desempenho do MCP quando emparelhado com o Cline para:

  • Listar todos os pacotes no ecossistema tidymodels
  • Fornecer informações detalhadas sobre pacotes específicos
  • Pesquisar funções R nos pacotes tidymodels
  • Gerar código de modelo para tarefas comuns do tidymodels
  • Pesquisar problemas nos repositórios tidymodels

Instalação

Pré-requisitos

Configuração

  1. Clone este repositório:

    git clone https://github.com/yourusername/tidymodels-mcp.git
    cd tidymodels-mcp
    
  2. Instale as dependências:

    npm install
    
  3. Compile o servidor:

    npm run build
    

Configuração

Token do GitHub (Opcional)

O servidor pode usar um token do GitHub para evitar limites de taxa ao acessar a API do GitHub. Para fornecer um token:

  1. Crie um token de acesso pessoal com o escopo public_repo.
  2. Adicione-o à sua configuração conforme mostrado abaixo.

Adicionando ao Cline no Visual Studio Code, Positron e IDEs de Código OSS

Depois de instalar a extensão do VS Code do Cline, navegue até o marketplace de Servidores MCP, onde você pode configurar as configurações do servidor MCP local. Em seguida, adicione o JSON ao cline_mcp_settings.json do Cline (se quiser aprovar automaticamente as ferramentas principais desta biblioteca de servidores MCP, mantenha os nomes mostrados na 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"
      ]
    }
  }
}

Adicionando ao Claude Desktop

Para usar este servidor MCP com o Claude Desktop, adicione-o ao seu 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": []
    }
  }
}

O arquivo de configuração geralmente está localizado em:

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

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas:

list_tidymodels_packages

Lista todos os pacotes no ecossistema tidymodels.

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

get_package_details

Obtém informações detalhadas sobre um pacote específico do tidymodels.

Arguments:
- package (required): Package name

search_r_functions

Pesquisa funções R nos pacotes tidymodels.

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

generate_tidymodels_code

Gera código R para tarefas comuns do tidymodels.

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

search_issues

Pesquisa problemas nos repositórios tidymodels.

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

Recursos Disponíveis

O servidor também fornece acesso a:

  • Todos os repositórios na organização tidymodels do GitHub
  • Documentação sobre pacotes tidymodels
  • Código de modelo para tarefas comuns

Exemplos de Uso

Aqui estão alguns exemplos de como usar este servidor MCP com o Cline:

Listando Pacotes Tidymodels

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

Obtendo Detalhes do Pacote

Can you tell me about the parsnip package in tidymodels?

Pesquisando Funções

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

Gerando Modelos de Código

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

Pesquisando Problemas

Show me open issues related to recipe preprocessing in tidymodels.

Desenvolvimento

Estrutura do Projeto

  • js/: Contém a implementação do servidor em JavaScript/Node.js
  • src/: Contém o código-fonte TypeScript (se estiver usando TypeScript)
  • build/: Diretório de saída para arquivos de compilação

Compilando a partir do Código-Fonte

Se você fez alterações nos arquivos TypeScript, pode recompilar o servidor com:

npm run build

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Agradecimentos