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（用于容器化执行）

构建

# Build the Docker image
task docker:build

# Run the server in Docker
task docker:run

使用 Docker 和 stdin/stdout

服务器可以在 Docker 中运行，同时保留 stdin/stdout 通信，这对 MCP 至关重要：

# 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 化版本在提供隔离和依赖管理的同时，也保留了这种通信模式。

许可证

知识共享署名-非商业性使用 4.0 国际版（CC-BY-NC 4.0）

本作品采用知识共享署名-非商业性使用 4.0 国际版许可协议授权。

详情请参阅 LICENSE 文件。