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 与 stdin/stdout

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

# 使用 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 传输与服务器通信，这是稳定性和可靠性的推荐方法。 dockerized 版本在提供隔离和依赖管理的同时，保持了这种通信模式。

许可证

知识共享署名-非商业性使用 4.0 国际许可协议 (CC-BY-NC 4.0)

本作品根据 知识共享署名-非商业性使用 4.0 国际许可协议 获得许可。

有关详细信息，请参见 LICENSE 文件。