Permite que los clientes de IA ejecuten código R en sesiones activas y registra MCP servers de terceros como herramientas en chats de R.
También conocido como posit-dev/mcptools
- Stars
- 206
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 20 oct 2026
- Licencia
- —
¿Qué es mcptools MCP?
mcptools es un MCP server. Permite que los clientes de IA ejecuten código R en sesiones activas y registra MCP servers de terceros como herramientas en chats de R.
Resumen generado a partir del README del proyecto
Acerca del MCP server de mcptools
Ejecutar código R directamente dentro de tus sesiones activas de programación con IA es lo que mcptools permite a científicos de datos y desarrolladores. Al implementar el Model Context Protocol en R, este paquete permite que asistentes de IA como Claude Desktop, Claude Code y VS Code GitHub Copilot interactúen con tu entorno de R en vivo. Puedes usar la función mcp_server para exponer funciones de R como herramientas, o usar la función mcp_session para otorgar a los modelos acceso a variables y objetos específicos en tus sesiones en ejecución.
Además de actuar como un servidor, el paquete también funciona como un cliente MCP. Esto te permite registrar MCP servers de terceros, como los de GitHub, Confluence o Google Drive, en tus aplicaciones de chat basadas en R. Al usar la función mcp_tools con la librería ellmer, puedes integrar estas herramientas externas en aplicaciones como shinychat o querychat, integrando diversas fuentes de datos en tus interfaces conversacionales impulsadas por R.
Qué puedes hacer con él
- 1Consultar datos de una sesión de R en vivoPide a un asistente de IA que encuentre valores específicos o estadísticas de resumen de un data frame que esté cargado actualmente en tu sesión interactiva de R.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Configuración
GITHUB_PERSONAL_ACCESS_TOKEN
| Nombre | Descripción | Tipo |
|---|---|---|
| GITHUB_PERSONAL_ACCESS_TOKEN | — |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleposit-dev/mcptools is public and reachablegithub.com/posit-dev/mcptools ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit or release 2026-10-20github.com/posit-dev/mcptools ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubmcptools
mcptools implements the Model Context Protocol in R. There are two sides to mcptools:
R as an MCP server:
When configured with mcptools, MCP-enabled tools like Claude Desktop, Claude Code, and VS Code GitHub Copilot can run R code in the sessions you have running to answer your questions. While the package supports configuring arbitrary R functions, you may be interested in the btw package’s integrated support for mcptools, which provides a default set of tools to to peruse the documentation of packages you have installed, check out the objects in your global environment, and retrieve metadata about your session and platform.
R as an MCP client:
Register third-party MCP servers with ellmer chats to integrate additional context into e.g. shinychat and querychat apps.
Installation
Install mcptools from CRAN with:
install.packages("mcptools")
You can install the development version of mcptools like so:
pak::pak("posit-dev/mcptools")
R as an MCP server
mcptools can be hooked up to any application that supports MCP. For
example, to use with Claude Desktop, you might paste the following in
your Claude Desktop configuration (on macOS, at
~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"r-mcptools": {
"command": "Rscript",
"args": ["-e", "mcptools::mcp_server()"]
}
}
}
Or, to use with Claude Code, you might type in a terminal:
claude mcp add -s "user" r-mcptools -- Rscript -e "mcptools::mcp_server()"
Then, if you’d like models to access variables in specific R sessions,
call mcptools::mcp_session() in those sessions. (You might include a
call to this function in your .Rprofile, perhaps using
usethis::edit_r_profile(), to automatically register every session you
start up.)
To deploy an HTTP MCP server to Posit Connect, add a _server.yml file
with engine: mcptools and a tools file:
engine: mcptools
tools: tools.R
Deploy the directory as an R API and mark it as MCP content:
rsconnect::deployAPI(".", contentCategory = "mcp")
If the content URL is https://connect.example.com/content/abc123/, use
https://connect.example.com/content/abc123/mcp as the MCP endpoint.
If you cannot set contentCategory = "mcp" during deployment, set the
MCP category in Connect after deploying and set minimum processes to at
least 1.
R as an MCP client
mcptools uses the Claude Desktop configuration file format to register third-party MCP servers, as most MCP servers provide setup instructions for Claude Desktop in their documentation. For example, here’s what the official GitHub MCP server configuration would look like:
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
Once the configuration file has been created (by default, mcptools will
look to file.path("~", ".config", "mcptools", "config.json")),
mcp_tools() will return a list of ellmer tools which you can pass
directly to the $set_tools() method from ellmer:
ch <- ellmer::chat_anthropic()
ch$set_tools(mcp_tools())
ch$chat("What issues are open on posit-dev/mcptools?")
Example
In Claude Desktop, I’ll write the following:
“From what year is the earliest recorded sample in the
foresteddata in my Positron session?”
Without mcptools, Claude couldn’t get far here; by default, it can’t run R code and doesn’t have any way to “speak to” my interactive R sessions.
Using the package, the model asks to describe the data frame using a structure that will show summary statistics from the data. mcptools will appropriately route the request to the open Positron session, forwarding the results back to the model for it to situate in a response.
Preguntas sobre mcptools MCP
¿Puede Claude Desktop ejecutar código R de mi sesión?
Sí. Con mcptools configurado como un MCP server, herramientas como Claude Desktop, Claude Code y VS Code Copilot pueden ejecutar código R en las sesiones que tengas abiertas.
¿Cómo instalo mcptools en R?
Instala la versión disponible en CRAN con install.packages("mcptools") o la versión de desarrollo desde GitHub con pak::pak("posit-dev/mcptools").
¿Cómo conecto mcptools a Claude Desktop?
Añade una entrada a tu archivo de configuración de Claude Desktop que ejecute Rscript -e "mcptools::mcp_server()" como comando del servidor.
¿Puede R usar MCP servers de terceros como herramientas?
Sí. mcptools registra MCP servers de terceros usando el formato de configuración de Claude Desktop, y mcp_tools() devuelve herramientas de ellmer que puedes pasar al método $set_tools() de un chat.
¿Puedo desplegar un mcptools MCP server en Posit Connect?
Sí. Añade un _server.yml con engine: mcptools y un archivo de herramientas, despliega el directorio como una R API y márcalo como contenido MCP.