Permite que clientes de IA executem código R em sessões ativas e registre MCP servers de terceiros como ferramentas em chats de R.
Também conhecido como posit-dev/mcptools
- Stars
- 206
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- —
- Último commit
- 20 de out. de 2026
- Licença
- —
O que é o MCP mcptools?
Permite que clientes de IA executem código R em sessões ativas e registre MCP servers de terceiros como ferramentas em chats de R.
Resumo gerado a partir do README do projeto
Sobre o MCP server de mcptools
Executar código R diretamente dentro de suas sessões de codificação de IA ativas é o que o mcptools possibilita para cientistas de dados e desenvolvedores. Ao implementar o Model Context Protocol no R, este pacote permite que assistentes de IA como Claude Desktop, Claude Code e VS Code GitHub Copilot interajam com seu ambiente R em tempo real. Você pode usar a função mcp_server para expor funções R como ferramentas, ou usar a função mcp_session para conceder aos modelos acesso a variáveis e objetos específicos em suas sessões em execução.
Além de atuar como um servidor, o pacote também funciona como um cliente MCP. Isso permite que você registre MCP servers de terceiros, como os do GitHub, Confluence ou Google Drive, em suas aplicações de chat baseadas em R. Ao usar a função mcp_tools com a biblioteca ellmer, você pode integrar essas ferramentas externas em apps como shinychat ou querychat, trazendo diversas fontes de dados para suas interfaces conversacionais orientadas por R.
O que você pode fazer com ele
- 1Consultar dados de uma sessão R ativaPeça a um assistente de IA para encontrar valores específicos ou estatísticas de resumo de um data frame que esteja carregado atualmente em sua sessão interativa de R.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Configuração
GITHUB_PERSONAL_ACCESS_TOKEN
| Nome | Descrição | Tipo |
|---|---|---|
| GITHUB_PERSONAL_ACCESS_TOKEN | — |
Verificações automatizadas
Executado em 13 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelposit-dev/mcptools is public and reachablegithub.com/posit-dev/mcptools ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)No licenseProblema encontrado
- Commit ou release no último anoLast commit or release 2026-10-20github.com/posit-dev/mcptools ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no 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.
Perguntas sobre o MCP mcptools
O Claude Desktop pode executar código R da minha sessão?
Sim. Com o mcptools configurado como um MCP server, ferramentas como Claude Desktop, Claude Code e VS Code Copilot podem executar código R nas sessões que você estiver utilizando.
Como eu instalo o mcptools no R?
Instale a versão lançada no CRAN com install.packages("mcptools") ou a versão de desenvolvimento via GitHub com pak::pak("posit-dev/mcptools").
Como eu conecto o mcptools ao Claude Desktop?
Adicione uma entrada ao seu arquivo de configuração do Claude Desktop que execute Rscript -e "mcptools::mcp_server()" como o comando do servidor.
O R pode usar MCP servers de terceiros como ferramentas?
Sim. O mcptools registra MCP servers de terceiros usando o formato de configuração do Claude Desktop, e o mcp_tools() retorna ferramentas do ellmer que você pode passar para o método $set_tools() de um chat.
Posso fazer o deploy de um mcptools MCP server no Posit Connect?
Sim. Adicione um _server.yml com engine: mcptools e um arquivo de ferramentas, faça o deploy do diretório como uma R API e marque-o como conteúdo MCP.