Tidymodels MCP 服务器

这是一个 Model Context Protocol (MCP) 服务器，它提供了与 R 中 tidymodels 生态系统相关的工具和资源。

概述

虽然这个 MCP 服务器可以扩展用于与工具无关的代理 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 生态系统中的所有包。

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 文件。

致谢

• tidymodels 团队提供了优秀的 R 包
• Model Context Protocol 使增强的人工智能能力成为可能