使用说明

项目简介

ClaudeR 是一个 R 包，它通过 MCP 服务器的方式，桥接了 Claude AI 和 RStudio。允许用户在 Claude 中直接控制 RStudio 环境，实现代码执行、数据分析、可视化等功能。借助 ClaudeR，Claude 能够像一个 RStudio 协作者一样，与用户进行交互式编程。

主要功能点

R 代码执行: Claude 可以直接在用户的 RStudio 会话中执行 R 代码，包括安装 R 包。
数据分析: Claude 可以访问和分析 RStudio 环境中的数据集，进行探索性数据分析和统计建模。
可视化: Claude 可以生成和改进 R 图表和可视化结果。
上下文感知: Claude 可以访问 RStudio 环境中的变量和函数，理解当前的工作上下文。
会话持久化: Claude 在 RStudio 中创建的变量、数据和函数在会话结束后仍然保留。

安装步骤

环境准备:
- 确保已安装 R 4.0+ 和 RStudio。
- 确保已安装 Python 3.8+ （用于 MCP 服务器组件）。
- 确保已安装 Claude 桌面应用程序。

安装 R 包依赖: 打开 RStudio，运行以下代码安装 ClaudeR 所需的 R 包依赖：

install.packages(c(
  "R6",
  "httpuv",
  "jsonlite",
  "miniUI",
  "shiny",
  "base64enc",
  "rstudioapi",
  "devtools"
))

安装 Python 依赖: 打开终端或命令提示符，运行以下命令安装 MCP 服务器所需的 Python 包：
```
pip install mcp httpx
```

安装 ClaudeR R 包: 在 RStudio 中运行以下代码从 GitHub 安装 ClaudeR 包：

devtools::install_github("IMNMV/ClaudeR")

配置 Claude 桌面应用: 根据你的操作系统，找到 Claude 桌面应用的配置文件 'claude_desktop_config.json'：
- Mac: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
如果文件不存在，请手动创建。打开该文件，添加或修改 'mcpServers' 部分，配置 ClaudeR MCP 服务器。将以下 JSON 代码添加到配置文件中：
```
{
  "mcpServers": {
    "r-studio": {
      "command": "python",
      "args": ["PATH_TO_REPOSITORY/ClaudeR/inst/scripts/persistent_r_mcp.py"],
      "env": {
        "PYTHONPATH": "PATH_TO_PYTHON_SITE_PACKAGES",
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}
```
配置参数说明:
- '"r-studio"': 服务器名称，可以自定义，Claude 客户端会使用此名称来识别和连接服务器。
- '"command": "python"': 启动服务器的命令，这里使用 Python 解释器。
- '"args": ["PATH_TO_REPOSITORY/ClaudeR/inst/scripts/persistent_r_mcp.py"]': 启动服务器的参数，指定 MCP 服务器脚本的路径。 请将 'PATH_TO_REPOSITORY' 替换为 ClaudeR 包在你的系统上的实际安装路径。 你可以在 RStudio 中运行 'find.package("ClaudeR")' 获取该路径。
- '"env"': 环境变量配置。
  - '"PYTHONPATH": "PATH_TO_PYTHON_SITE_PACKAGES"': 请将 'PATH_TO_PYTHON_SITE_PACKAGES' 替换为你的 Python 'site-packages' 目录的实际路径。 这个路径取决于你的 Python 安装方式和环境。
  - '"PYTHONUNBUFFERED": "1"': 强制 Python 输出不缓冲，确保实时通信。

基本使用方法

启动 RStudio Addin: 在 RStudio 中加载 ClaudeR 包并启动 Addin：

library(ClaudeR)
claudeAddin()

启动 MCP 服务器: 在 ClaudeR Addin 界面中，点击 "Start Server" 按钮启动 MCP 服务器。保持 Addin 窗口打开，但可以切换到 RStudio 的其他视图（例如 Files, Plots, Viewers 等）。 请勿点击 "Stop Server" 按钮，除非你想断开连接。
在 Claude Desktop 中与 RStudio 互动: 打开 Claude 桌面应用程序，现在你可以指示 Claude 执行 R 代码。例如，你可以提问：
- "I have a dataset loaded in my env named data, please perform exploratory data analysis on it and run relevant statistical analyses"
- "Load the mtcars dataset and create a scatterplot of mpg vs. hp with a trend line"
- "Fit a linear model to predict mpg based on weight and horsepower"
Claude 将会通过 MCP 服务器连接到 RStudio，执行 R 代码，并将结果返回给你。

重要提示:

确保 Claude 桌面应用程序已正确配置 MCP 服务器信息。
每次 RStudio 会话只能连接到一个 Claude 会话。
ClaudeR Addin 窗口必须保持打开状态才能维持连接。
首次使用或遇到连接问题时，建议重启 RStudio 和 Claude 桌面应用程序。

关键词

使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息