MCPSafari
nicoconic248/MCPSafari
Automação nativa do Safari no macOS para agentes de IA via MCP
Ver no GitHubServidor MCP nativo que permite que agentes de IA controlem Safari no macOS de forma local. Oferece ferramentas para manipular abas, preencher formulários, extrair HTML, executar JavaScript, capturar screenshots e acessar dados de rede.
Instalação
npx convez-ai nicoconic248/MCPSafari1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automação de tarefas web sem ferramentas externas no navegador
- Preenchimento automático de formulários e interação com páginas
- Extração de conteúdo HTML e dados de rede para análise
Veredito

Solução prática para usuários macOS que precisam automação web via IA sem dependências externas. Implementação direta em JavaScript com bom suporte para tarefas comuns, mas limitado ao ecossistema Safari/macOS.
README
A tradução para o português deste README ainda está na fila.
🧭 MCPSafari - Run Safari With AI Control
🛠️ What MCPSafari Does
MCPSafari is a native Safari MCP server for AI agents on macOS. It lets an AI tool work with Safari through a local connection on your Mac.
Use it to:
- open web pages in Safari
- read page content
- work with forms and buttons
- handle simple web tasks
- support browser automation from AI tools
It is made for users who want Safari-based automation without extra setup in the browser itself.
📥 Download and Install
Visit this page to download and set up MCPSafari:
Steps to get started
- Open the download page above.
- Get the latest release or source package from the repository page.
- Copy the files to a folder on your Mac.
- Open the app or server file from that folder.
- Allow macOS to run it if prompted.
- Keep Safari open when you want to use browser control.
If you use an AI app that supports MCP, point it to the MCPSafari server after setup.
🖥️ System Requirements
MCPSafari is built for:
- macOS
- Safari
- an AI app that supports MCP
- a modern Apple Silicon or Intel Mac
For the best result, use:
- the latest version of macOS you can run
- the latest Safari version
- one MCP-ready AI client
⚙️ How It Works
MCPSafari runs on your Mac and connects Safari to an AI tool through the Model Context Protocol.
Basic flow:
- You start MCPSafari on your Mac.
- Safari opens or stays open.
- Your AI app connects to the local MCP server.
- The AI sends browser actions to Safari.
- Safari carries out the task on the page.
This setup keeps the browser on your computer and gives the AI a direct path to browser actions.
🚀 Getting Started
1. Open the repository
Go to the main project page:
2. Get the project files
Download the project from the repository page. If the page offers a release build, use that. If it offers source files, download the full project package.
3. Place the files in a folder
Move the files into a folder you can find again, such as:
- Downloads
- Applications
- Desktop
- a folder named MCPSafari
4. Start MCPSafari
Open the app, launcher, or server file that came with the project.
If macOS asks for permission:
- choose Open
- allow local network or automation access if shown
- allow Safari control if prompted
5. Keep Safari ready
Open Safari before you start a task, or let MCPSafari open it for you.
6. Connect your AI app
In your MCP client:
- add the MCPSafari server
- use the local path or command from the project files
- restart the client if needed
Once connected, the AI tool can work with Safari through the server.
🔍 What You Can Do With It
MCPSafari helps with common browser tasks such as:
- opening pages in Safari
- clicking links and buttons
- filling out forms
- reading page text
- moving through web pages
- checking simple page state
- supporting website tasks for AI agents
It fits well with:
- agentic AI workflows
- web automation
- browser automation
- accessibility-driven control
- devtools-style page inspection
🧩 Typical Use Cases
Use MCPSafari when you want an AI tool to:
- search the web in Safari
- open a site and read content
- move through a site step by step
- test a page flow
- collect text from a page
- complete a basic web form
- help with repeat browser tasks
It works best when the page has clear buttons, fields, and text.
🔐 Permissions You May Need
Safari automation on macOS can ask for access the first time you run it. This is normal.
You may need to allow:
- Automation
- Accessibility
- Input monitoring
- Local network access
If a prompt appears:
- Open System Settings.
- Find Privacy & Security.
- Check the app access list.
- Turn on the access MCPSafari needs.
- Try the task again.
🧪 First Run Checklist
Before you use MCPSafari, check these items:
- Safari is installed
- your Mac runs macOS
- the project files are in one folder
- your AI app supports MCP
- you have allowed the needed permissions
- Safari is open if the task needs an active browser
📂 Suggested Folder Setup
A simple folder layout can help:
- Downloads
- MCPSafari
- Applications
- MCPSafari
- Documents
- AI Tools
- MCPSafari
- AI Tools
Keep the app and any config files together so they are easy to find later.
🧠 Tips for Best Results
Use these tips to avoid common issues:
- Keep Safari on the screen while the AI works.
- Use one tab for the task.
- Close extra tabs you do not need.
- Sign in to websites before you start a task.
- Use simple page layouts when possible.
- Reload the page if the task gets stuck.
- Restart the MCP client if the server stops responding.
If a site uses many pop-ups or nested menus, the AI may need more steps to finish the task.
🧭 Common Tasks
Open a web page
The AI can send Safari to a page you choose.
Read page content
The AI can collect visible text from the page for later use.
Click controls
The AI can click buttons, links, checkboxes, and other page controls.
Fill forms
The AI can type into fields and submit simple forms.
Work through page steps
The AI can move through a checkout flow, signup flow, or help page flow when the site is simple.
🛡️ Privacy and Local Use
MCPSafari runs on your Mac and works with Safari on your machine. This setup keeps browser control local.
That means:
- Safari stays on your computer
- page actions run from your local system
- your AI client connects to the local server
For personal use, this makes it easier to keep control of the browser session.
🧰 Troubleshooting
Safari does not respond
- make sure Safari is open
- check that the right tab is active
- restart MCPSafari
- restart Safari if needed
The AI app cannot connect
- confirm the MCP server is running
- check the server path in your client
- restart the AI app
- verify the client supports MCP
macOS blocks the app
- open System Settings
- go to Privacy & Security
- allow the app to run
- approve Automation or Accessibility access
The page does not load right
- refresh the page in Safari
- close extra tabs
- try again on a simpler page
Clicks or typing fail
- check that Safari has focus
- make sure the field is editable
- give the app the needed permissions
📌 Recommended Setup for New Users
If this is your first time using an MCP browser tool, start with this setup:
- one Mac
- Safari open
- one MCP-compatible AI app
- the MCPSafari project files in a clear folder
- a simple website for your first test
Try a short task first, such as opening a page and reading the text. Then move to form filling or multi-step pages.
🧷 Project Focus
MCPSafari is aimed at users who want:
- Safari automation
- AI agent browser control
- local macOS support
- a native Safari path for MCP tools
- web tasks handled through familiar browser actions
📎 Download Again
If you need the project files again, use this page:
🗂️ Topic Areas
This project fits topics like:
- accessibility
- agentic AI
- AI agent tools
- AI agents
- AI tools
- automation
- browser automation
- Claude
- devtools
- LLM tools
- macOS
- MCP
- Model Context Protocol
- Safari
- Safari extension
- Swift
- web automation