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