Tidymodels MCP Server

Tidymodels MCP サーバー

R の tidymodels エコシステムを扱うためのツールとリソースを提供する Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーは、ツールに依存しないエージェント型 AI ワークフローで利用できるよう拡張可能ですが、現状ではローカル MCP サーバーとして Cline.bot および Claude Desktop と組み合わせて使用できます。この MCP の目的は、tidymodels エコシステム、特に tidymodels 組織の配下にある GitHub リポジトリを監視し、tidymodels のパッケージ、関数、一般的なワークフローに関する包括的な情報を提供することです。

現在、Cline と組み合わせると、次の用途で MCP のパフォーマンスが向上しています。

• tidymodels エコシステム内のすべてのパッケージを一覧表示する
• 特定のパッケージに関する詳細情報を提供する
• tidymodels のパッケージ全体から R 関数を検索する
• 一般的な tidymodels タスク用のテンプレートコードを生成する
• tidymodels のリポジトリ内の issue を検索する

インストール

前提条件

• 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 トークン（任意）

GitHub API へのアクセス時にレート制限を回避するため、サーバーで GitHub トークンを使用できます。トークンを指定するには、次の手順に従います。

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 のリポジトリ内の issue を検索します。

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.

issue を検索する

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 ファイルを参照してください。

謝辞

• 優れた R パッケージを提供している tidymodels チーム
• AI の機能強化を可能にしている Model Context Protocol