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