R-Server MCP

R-Server MCP

AI モデルが R の ggplot2 ライブラリを使用してデータの可視化を生成し、R スクリプトを実行できるようにする、特化型の Model Context Protocol（MCP）サーバーです。

概要

この MCP サーバーは、R 環境に直接アクセスすることなく、統計的な可視化の作成や R スクリプトの実行を行うためのシンプルなインターフェースを提供します。2 つの MCP ツールを公開します。

• render_ggplot：ggplot2 コマンドを含む R コードから可視化を生成します
• execute_r_script：任意の R スクリプトを実行し、テキスト出力を返します

機能

• ggplot2 の描画：ggplot2 コマンドを含む R コードを実行し、生成された可視化を返します
• R スクリプトの実行：任意の R スクリプトを実行し、テキスト出力を返します
• 形式の選択肢：PNG、JPEG、PDF、SVG の出力形式に対応します
• カスタマイズ：画像の寸法と解像度を制御できます
• エラー処理：無効な R コードや描画の失敗に対して、明確なエラーメッセージを表示します
• MCP プロトコルへの準拠：Model Context Protocol を完全に実装しています
• Docker との統合：分離されたコンテナ内で R コードを安全に実行します

要件

• Go 1.22 以降
• ggplot2 パッケージを含む R 4.0 以降
• Docker（コンテナでの実行に使用）

ビルド

# Build the Docker image
task docker:build

# Run the server in Docker
task docker:run

stdin/stdout を使用した Docker の利用

MCP に不可欠な stdin/stdout 通信を維持しながら、サーバーを Docker で実行できます。

# Build and run using docker-compose
./start_server.sh --docker

または、環境変数を設定します。

USE_DOCKER=true ./start_server.sh

この方法により、ホストとコンテナ間で stdin と stdout が適切に接続され、シームレスな MCP 通信が可能になります。

使用方法

MCP との統合

このサーバーを MCP クライアントで使用するには、MCP 設定ファイルで設定してください。

ローカルでの実行

{
  "mcpServers": {
    "r-server": {
      "command": "/path/to/r-server",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Docker での実行

{
  "mcpServers": {
    "r-server": {
      "command": "/path/to/start_server.sh",
      "args": ["--docker"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

MCP クライアントは、安定性と信頼性のために推奨される stdio トランスポートを使用して、サーバーと自動的に通信します。Docker 化されたバージョンでもこの通信方式を維持しながら、分離と依存関係の管理を実現します。

ライセンス

Creative Commons Attribution-NonCommercial 4.0 International（CC-BY-NC 4.0）

この作品は、Creative Commons Attribution-NonCommercial 4.0 International Licenseの下でライセンスされています。

詳細については、LICENSEファイルをご覧ください。