Rlang MCP Server

🚀 R-Server MCP

R-Server MCP是一個專業的模型上下文協議（MCP）服務器，它支持AI模型藉助R語言的ggplot2庫生成數據可視化內容，還能執行R腳本，為數據處理和可視化提供了便捷的解決方案。

🚀 快速開始

此MCP服務器提供了一個簡化的接口，用於生成統計圖表和執行R腳本，而無需直接訪問R環境。它公開了兩個MCP工具：

• render_ggplot：從包含ggplot2命令的R代碼生成可視化
• execute_r_script：執行任何R腳本並返回文本輸出

✨ 主要特性

• 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 國際許可（CC-BY-NC 4.0）

本作品根據知識共享署名 - 非商業性使用 4.0 國際許可發佈。

有關詳細信息，請參閱LICENSE文件。