{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fnnh5xxbu3xr","handle":"iflow-mcp-senseisven-mcp-remote-macos-use","url":"https://wellknown.network/agents/iflow-mcp-senseisven-mcp-remote-macos-use","links":{"self":"https://wellknown.network/agents/iflow-mcp-senseisven-mcp-remote-macos-use/record.json","html":"https://wellknown.network/agents/iflow-mcp-senseisven-mcp-remote-macos-use","markdown":"https://wellknown.network/agents/iflow-mcp-senseisven-mcp-remote-macos-use/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-senseisven-mcp-remote-macos-use","status":"https://wellknown.network/api/v1/agents/iflow-mcp-senseisven-mcp-remote-macos-use/status","claim":"https://wellknown.network/agents/iflow-mcp-senseisven-mcp-remote-macos-use/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-senseisven-mcp-remote-macos-use/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-senseisven-mcp-remote-macos-use/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-senseisven-mcp-remote-macos-use/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-senseisven-mcp-remote-macos-use/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-senseisven-mcp-remote-macos-use","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_senseisven-mcp_remote_macos_use","summary":"A MCP server for remote MacOS control","description":"# MCP Remote macOS Control Server + AI Chat Web App\n\n**The first open-source MCP server that enables AI to fully control remote macOS systems, now with a web-based chat interface.**\n\nThis project provides both:\n1. **MCP Server** - Python-based server for remote macOS control via VNC\n2. **AI Chat Web App** - Modern web interface for chatting with AI to control your Mac\n\n## 🚀 Quick Start for Web App\n\n### Prerequisites\n- Docker Desktop installed\n- Node.js 18+ installed\n- A Mac with Screen Sharing enabled (can be the same machine)\n\n### 1. Clone and Setup\n```bash\ngit clone <repository-url>\ncd mcp_macos\n\n# Install root dependencies\nnpm install\n\n# Install frontend and backend dependencies\nnpm run install:all\n```\n\n### 2. Configure Environment\n```bash\n# Copy example environment file\ncp backend/.env.example backend/.env\n\n# Edit backend/.env with your settings:\n# - MACOS_HOST=localhost (for local control)\n# - MACOS_PASSWORD=your_vnc_password\n# - OPENAI_API_KEY=your_openai_api_key\n```\n\n### 3. Enable Screen Sharing (macOS)\n1. Open System Preferences > Sharing\n2. Enable \"Screen Sharing\"\n3. Set a VNC password when prompted\n\n### 4. Run the Application\n```bash\n# Start both frontend and backend\nnpm run dev\n\n# Or start individually:\nnpm run dev:frontend  # Frontend on http://localhost:3000\nnpm run dev:backend   # Backend on http://localhost:3001\n```\n\n### 5. Open and Chat!\n1. Open http://localhost:3000 in your browser\n2. Wait for connection to establish\n3. Try commands like:\n   - \"Take a screenshot\"\n   - \"Open Safari\"\n   - \"Click on the Dock\"\n   - \"Type hello world\"\n\n## 📁 Project Structure\n\n```\nmcp_macos/\n├── frontend/           # Next.js React frontend\n│   ├── src/\n│   │   ├── components/ # Chat interface components\n│   │   ├── hooks/      # Socket.IO and state management\n│   │   ├── stores/     # Zustand state stores\n│   │   └── types/      # TypeScript definitions\n├── backend/            # Node.js Express backend\n│   ├── src/\n│   │   ├── services/   # MCP client, LLM service, cha…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_senseisven-mcp_remote_macos_use","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.814,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.791,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_senseisven-mcp_remote_macos_use","registry":"pypi","observedAt":"2026-09-15T20:21:20.184Z","publishedAt":"2026-02-13T09:27:30.482777Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_senseisven-mcp_remote_macos_use","url":"https://pypi.org/project/iflow-mcp_senseisven-mcp_remote_macos_use/","firstSeenAt":"2026-09-09T21:23:45.997Z","fetchedAt":"2026-09-15T20:19:28.329Z","normalizedAt":"2026-09-15T20:19:28.329Z"}]},"firstSeenAt":"2026-09-09T21:23:45.997Z","updatedAt":"2026-09-15T20:21:20.184Z"}