Permet aux clients IA d'exécuter du code R dans des sessions actives et d'enregistrer des MCP servers tiers comme outils dans les chats R.
Aussi connu sous posit-dev/mcptools
- Étoiles
- 206
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 20 oct. 2026
- Licence
- —
Qu'est-ce que mcptools MCP ?
mcptools est un serveur MCP. Permet aux clients IA d'exécuter du code R dans des sessions actives et d'enregistrer des MCP servers tiers comme outils dans les chats R.
Résumé généré à partir du README du projet
À propos du MCP server mcptools
L'exécution directe de code R au sein de vos sessions de codage IA actives est ce que mcptools permet aux data scientists et aux développeurs. En implémentant le Model Context Protocol dans R, ce package permet à des assistants IA comme Claude Desktop, Claude Code et VS Code GitHub Copilot d'interagir avec votre environnement R en direct. Vous pouvez utiliser la fonction mcp_server pour exposer des fonctions R en tant qu'outils, ou utiliser la fonction mcp_session pour accorder aux modèles l'accès à des variables et objets spécifiques dans vos sessions en cours.
Au-delà de son rôle de serveur, le package fonctionne également comme un client MCP. Cela vous permet d'enregistrer des MCP servers tiers, tels que ceux pour GitHub, Confluence ou Google Drive, dans vos applications de chat basées sur R. En utilisant la fonction mcp_tools avec la bibliothèque ellmer, vous pouvez intégrer ces outils externes dans des applications comme shinychat ou querychat, apportant ainsi des sources de données diverses dans vos interfaces conversationnelles pilotées par R.
Ce que vous pouvez faire avec
- 1Interroger les données d'une session R en directDemandez à un assistant IA de trouver des valeurs spécifiques ou des statistiques descriptives à partir d'un data frame actuellement chargé dans votre session R interactive.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Configuration
GITHUB_PERSONAL_ACCESS_TOKEN
| Nom | Description | Type |
|---|---|---|
| GITHUB_PERSONAL_ACCESS_TOKEN | — |
Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleposit-dev/mcptools is public and reachablegithub.com/posit-dev/mcptools ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)No licenseFaille
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-20github.com/posit-dev/mcptools ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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.
Questions sur mcptools MCP
Est-ce que Claude Desktop peut exécuter du code R de ma session ?
Oui. Avec mcptools configuré comme un MCP server, des outils comme Claude Desktop, Claude Code et VS Code Copilot peuvent exécuter du code R dans les sessions que vous avez en cours.
Comment installer mcptools dans R ?
Installez la version publiée sur CRAN avec install.packages("mcptools"), ou la version de développement depuis GitHub avec pak::pak("posit-dev/mcptools").
Comment connecter mcptools à Claude Desktop ?
Ajoutez une entrée à votre fichier de configuration Claude Desktop qui exécute Rscript -e "mcptools::mcp_server()" comme commande de serveur.
R peut-il utiliser des MCP servers tiers comme outils ?
Oui. mcptools enregistre des MCP servers tiers en utilisant le format de configuration de Claude Desktop, et mcp_tools() renvoie des outils ellmer que vous pouvez passer à la méthode $set_tools() d'un chat.
Puis-je déployer un MCP server mcptools sur Posit Connect ?
Oui. Ajoutez un _server.yml avec engine: mcptools et un fichier de tools, déployez le répertoire en tant qu'API R, et marquez-le comme contenu MCP.