Tidymodels MCP Server

Tidymodels MCP Server

一个 Model Context Protocol（MCP）服务，为在 R 中使用 tidymodels 生态系统提供工具和资源。

概览

虽然此 MCP 服务可扩展，以用于不依赖特定工具的 Agentic AI 工作流，但目前可将它作为本地 MCP 服务与 Cline.bot 和 Claude Desktop 配合使用。此 MCP 的用途是监控 tidymodels 生态系统，特别是tidymodels 组织下的 GitHub 存储库，提供有关 tidymodels 软件包、函数和常见工作流的全面信息。

目前，与 Cline 配合使用时，我能获得更好的 MCP 性能，可用于：

• 列出 tidymodels 生态系统中的所有软件包
• 提供特定软件包的详细信息
• 搜索 tidymodels 软件包中的 R 函数
• 为常见 tidymodels 任务生成模板代码
• 搜索 tidymodels 存储库中的问题

安装

先决条件

• Node.js（v14 或更高版本）
• npm

设置

1. 克隆此存储库：

   git clone https://github.com/yourusername/tidymodels-mcp.git
   cd tidymodels-mcp
   

2. 安装依赖项：

   npm install
   

3. 构建服务：

   npm run build
   

配置

GitHub Token（可选）

服务可以使用 GitHub token，在访问 GitHub API 时避免触发速率限制。提供 token 的方法：

1. 创建个人访问 token，并授予 public_repo 权限范围。
2. 按照下文所示将其添加到配置中。

添加到 Visual Studio Code、Positron 和 OSS Code IDE 中的 Cline

安装 Cline 的 VS Code 扩展后，前往其 MCP Servers 市场，在那里可以配置本地 MCP 服务设置。然后，将 JSON 添加到 Cline 的 cline_mcp_settings.json 中（如果希望自动批准此 MCP 服务库中的核心工具，请保留 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"
      ]
    }
  }
}

添加到 Claude Desktop

若要将此 MCP 服务与 Claude Desktop 配合使用，请将其添加到 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": []
    }
  }
}

配置文件通常位于：

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

可用工具

此服务提供以下工具：

list_tidymodels_packages

列出 tidymodels 生态系统中的所有软件包。

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

get_package_details

获取特定 tidymodels 软件包的详细信息。

Arguments:
- package (required): Package name

search_r_functions

搜索 tidymodels 软件包中的 R 函数。

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

generate_tidymodels_code

为常见 tidymodels 任务生成 R 代码。

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

search_issues

搜索 tidymodels 存储库中的问题。

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

可用资源

此服务还提供以下内容：

• tidymodels GitHub 组织中的所有存储库
• tidymodels 软件包的文档
• 常见任务的模板代码

使用示例

以下是使用 Cline 调用此 MCP 服务的一些示例：

列出 Tidymodels 软件包

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

获取软件包详情

Can you tell me about the parsnip package in tidymodels?

搜索函数

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

生成代码模板

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

搜索问题

Show me open issues related to recipe preprocessing in tidymodels.

开发

项目结构

• js/：包含 JavaScript/Node.js 服务实现
• src/：包含 TypeScript 源代码（若使用 TypeScript）
• build/：构建文件的输出目录

从源代码构建

如果修改了 TypeScript 文件，可以使用以下命令重新构建服务：

npm run build

许可证

此项目采用 MIT License 许可协议；详情请参阅 LICENSE 文件。

致谢

• 感谢 tidymodels 团队提供优秀的 R 包
• 感谢 Model Context Protocol 赋能增强型 AI 功能