Tidymodels MCP 服务器

一个模型上下文协议 (MCP) 服务器，为在 R 中使用 tidymodels 生态系统提供工具和资源。

概述

虽然此 MCP 服务器可扩展用于与工具无关的 Agentic AI 工作流程，但目前它可以与 Cline.bot 和 Claude Desktop 配对作为本地 MCP 服务器。此 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. 创建一个具有 public_repo 范围的个人访问令牌。
2. 将其添加到您的配置中，如下所示。

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

安装 Cline 的 VS Code 扩展后，导航到其 MCP 服务器市场，您可以在其中配置本地 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 生态系统中的所有包。

参数：
- refresh (可选): 强制刷新存储库缓存

get_package_details

获取关于特定 tidymodels 包的详细信息。

参数：
- package (必需): 包名

search_r_functions

在 tidymodels 包中搜索 R 函数。

参数：
- query (必需): 要搜索的函数名或关键字
- package (可选): 将搜索限制为特定包

generate_tidymodels_code

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

参数：
- task (必需): 任务描述
- template (可选): 模板类型 (recipe, model, tune, evaluation)

search_issues

在 tidymodels 存储库中搜索问题。

参数：
- query (必需): 搜索查询
- repo (可选): 将搜索限制为特定存储库
- state (可选): 问题状态 (open, closed, all)

可用资源

服务器还提供对以下内容的访问：

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

使用示例

以下是一些如何将此 MCP 服务器与 Cline 一起使用的示例：

列出 Tidymodels 包

我想知道 tidymodels 生态系统中有哪些包可用。

获取包详细信息

你能告诉我关于 tidymodels 中的 parsnip 包吗？

搜索函数

我需要找到与 tidymodels 中的交叉验证相关的 R 函数。

生成代码模板

生成一个 tidymodels 工作流程的代码，该工作流程使用随机森林预测房价。

搜索问题

显示 tidymodels 中与 recipe 预处理相关的未解决问题。

开发

项目结构

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

从源代码构建

如果您对 TypeScript 文件进行了更改，可以使用以下命令重建服务器：

npm run build

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• tidymodels 团队及其出色的 R 包
• 模型上下文协议，用于增强 AI 功能