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