{"id":26641113,"url":"https://github.com/javorraca/tidymodels-mcp","last_synced_at":"2026-04-28T22:34:58.198Z","repository":{"id":283396520,"uuid":"951634672","full_name":"JavOrraca/tidymodels-mcp","owner":"JavOrraca","description":"This repo contains source code for a Tidymodels MCP server that I developed that allows Cline's coding workflows to be context aware of all public repositories and documentation under https://github.com/tidymodels, intended for use with Anthropic's Claude services..","archived":false,"fork":false,"pushed_at":"2025-03-20T03:19:41.000Z","size":2,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-20T03:20:25.493Z","etag":null,"topics":["cline","mcp","rstats","tidymodels"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JavOrraca.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-20T02:01:27.000Z","updated_at":"2025-03-20T03:19:44.000Z","dependencies_parsed_at":"2025-03-20T03:35:04.867Z","dependency_job_id":null,"html_url":"https://github.com/JavOrraca/tidymodels-mcp","commit_stats":null,"previous_names":["javorraca/tidymodels-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavOrraca%2Ftidymodels-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavOrraca%2Ftidymodels-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavOrraca%2Ftidymodels-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JavOrraca%2Ftidymodels-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JavOrraca","download_url":"https://codeload.github.com/JavOrraca/tidymodels-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245325220,"owners_count":20596818,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cline","mcp","rstats","tidymodels"],"created_at":"2025-03-24T18:19:46.962Z","updated_at":"2026-04-28T22:34:58.155Z","avatar_url":"https://github.com/JavOrraca.png","language":"JavaScript","funding_links":[],"categories":["Data Science Tools"],"sub_categories":["How to Submit"],"readme":"# Tidymodels MCP Server\n\n![](tidymodels_mcp_banner.png)\n\nA Model Context Protocol (MCP) server that provides tools and resources for working with the [tidymodels](https://www.tidymodels.org/) ecosystem in R.\n\n## Overview\n\nWhile this MCP server is extensible for use with tool-agnostic agentic AI workflows, in it's current form it can be paired with [Cline.bot](https://cline.bot/) and [Claude Desktop](https://claude.ai/download) as a local MCP server. The purpose of this MCP is to monitor the tidymodels ecosystem, specifically the GitHub repositories [under the tidymodels organization](https://github.com/tidymodels), providing comprehensive information about tidymodels packages, functions, and common workflows.\n\nCurrently, I'm getting better MCP performance when paired with Cline to:\n\n- List all packages in the tidymodels ecosystem\n- Provide detailed information about specific packages\n- Search for R functions across tidymodels packages\n- Generate template code for common tidymodels tasks\n- Search for issues in tidymodels repositories\n\n## Installation\n\n### Prerequisites\n\n- [Node.js](https://nodejs.org/) (v14 or later)\n- [npm](https://www.npmjs.com/)\n\n### Setup\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/yourusername/tidymodels-mcp.git\n   cd tidymodels-mcp\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Build the server:\n   ```bash\n   npm run build\n   ```\n\n## Configuration\n\n### GitHub Token (Optional)\n\nThe server can use a GitHub token to avoid rate limits when accessing the GitHub API. To provide a token:\n\n1. [Create a personal access token](https://github.com/settings/tokens) with the `public_repo` scope.\n2. Add it to your configuration as shown below.\n\n### Adding to Cline in Visual Studio Code, Positron, and OSS Code IDEs\n\nAfter you've installed Cline's VS Code extension, navigate to its MCP Servers marketplace where you can configure local MCP server settings. Then, add the JSON to Cline's `cline_mcp_settings.json` (if you want to autoapprove the core tools within this MCP server library, keep the names shown in the `autoApprove` list):\n\n```json\n{\n  \"mcpServers\": {\n    \"tidymodels\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/tidymodels-mcp/js/index.js\"],\n      \"env\": {\n        \"GITHUB_TOKEN\": \"your-github-token\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": [\n        \"list_tidymodels_packages\",\n        \"get_package_details\",\n        \"search_r_functions\",\n        \"generate_tidymodels_code\",\n        \"search_issues\"\n      ]\n    }\n  }\n}\n```\n\n### Adding to Claude Desktop\n\nTo use this MCP server with [Claude Desktop](https://claude.ai/download), add it to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"tidymodels\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/tidymodels-mcp/js/index.js\"],\n      \"env\": {\n        \"GITHUB_TOKEN\": \"your-github-token\"\n      },\n      \"disabled\": false,\n      \"autoApprove\": []\n    }\n  }\n}\n```\n\nThe config file is typically located at:\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- Linux: `~/.config/Claude/claude_desktop_config.json`\n\n## Available Tools\n\nThe server provides the following tools:\n\n### list_tidymodels_packages\n\nLists all packages in the tidymodels ecosystem.\n\n```\nArguments:\n- refresh (optional): Force a refresh of the repository cache\n```\n\n### get_package_details\n\nGet detailed information about a specific tidymodels package.\n\n```\nArguments:\n- package (required): Package name\n```\n\n### search_r_functions\n\nSearch for R functions in tidymodels packages.\n\n```\nArguments:\n- query (required): Function name or keyword to search for\n- package (optional): Limit search to a specific package\n```\n\n### generate_tidymodels_code\n\nGenerate R code for common tidymodels tasks.\n\n```\nArguments:\n- task (required): Description of the task\n- template (optional): Type of template (recipe, model, tune, evaluation)\n```\n\n### search_issues\n\nSearch for issues in tidymodels repositories.\n\n```\nArguments:\n- query (required): Search query\n- repo (optional): Limit search to a specific repository\n- state (optional): Issue state (open, closed, all)\n```\n\n## Available Resources\n\nThe server also provides access to:\n\n- All repositories in the tidymodels GitHub organization\n- Documentation about tidymodels packages\n- Template code for common tasks\n\n## Usage Examples\n\nHere are some examples of how to use this MCP server with Cline:\n\n### Listing Tidymodels Packages\n\n```\nI'd like to know what packages are available in the tidymodels ecosystem.\n```\n\n### Getting Package Details\n\n```\nCan you tell me about the parsnip package in tidymodels?\n```\n\n### Searching for Functions\n\n```\nI need to find R functions related to cross-validation in tidymodels.\n```\n\n### Generating Code Templates\n\n```\nGenerate code for a tidymodels workflow that predicts housing prices using random forests.\n```\n\n### Searching Issues\n\n```\nShow me open issues related to recipe preprocessing in tidymodels.\n```\n\n## Development\n\n### Project Structure\n\n- `js/`: Contains the JavaScript/Node.js server implementation\n- `src/`: Contains the TypeScript source (if using TypeScript)\n- `build/`: Output directory for build files\n\n### Building from Source\n\nIf you've made changes to the TypeScript files, you can rebuild the server with:\n\n```bash\nnpm run build\n```\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- The [tidymodels](https://www.tidymodels.org/) team for their excellent R packages\n- The [Model Context Protocol](https://docs.anthropic.com/claude/docs/model-context-protocol) for enabling enhanced AI capabilities\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjavorraca%2Ftidymodels-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjavorraca%2Ftidymodels-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjavorraca%2Ftidymodels-mcp/lists"}