Rlang MCP Server

🚀 R-Server MCP

専門的なモデルコンテキストプロトコル（MCP）サーバーです。AIモデルがR言語のggplot2ライブラリを使用してデータの可視化を生成し、Rスクリプトを実行することをサポートします。

🚀 クイックスタート

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

✨ 主な機能

• ggplot2によるプロット：ggplot2コマンドを含むRコードを実行し、結果のグラフを返します。
• Rスクリプトの実行：任意のRスクリプトを実行し、テキスト出力を返します。
• 形式オプション：PNG、JPEG、PDF、SVGの出力形式をサポートします。
• カスタマイズオプション：画像のサイズと解像度を制御できます。
• エラー処理：無効なRコードやレンダリング失敗に対して明確なエラーメッセージを提供します。
• MCPプロトコル準拠：完全なモデルコンテキストプロトコルの実装です。
• Docker統合：隔離されたコンテナ内で安全にRコードを実行します。

📦 インストール

前提条件

• Go 1.22以上
• R 4.0以上で、ggplot2パッケージがインストールされていること
• Docker（コンテナ化実行用）

ビルド

# Dockerイメージをビルドする
task docker:build

# Docker内でサーバーを実行する
task docker:run

Dockerと標準入出力の使用

サーバーは、標準入出力通信を維持したままDocker内で実行できます。これはMCPにとって重要です。

# docker-composeでビルドして実行する
./start_server.sh --docker

または、環境変数を設定することもできます。

USE_DOCKER=true ./start_server.sh

この方法により、ホストとコンテナ間の標準入出力が正しく接続され、シームレスな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版は、この通信モードを維持しながら、隔離と依存関係の管理を提供します。

📄 ライセンス

この作品はクリエイティブ・コモンズ 表示 - 非営利 4.0 国際 ライセンスの下で公開されています。詳細については、LICENSEファイルを参照してください。