{"id":29556541,"url":"https://github.com/onkernel/kernel-mcp-server","last_synced_at":"2025-07-22T16:01:47.311Z","repository":{"id":304990453,"uuid":"1020354940","full_name":"onkernel/kernel-mcp-server","owner":"onkernel","description":"Open-source MCP server for secure, low-latency cloud-browser automation on Kernel.","archived":false,"fork":false,"pushed_at":"2025-07-17T16:17:26.000Z","size":120,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-17T17:44:19.704Z","etag":null,"topics":["ai-agents","browser-automation","cloud-browser","devtool","headless-chromium","kernel","mcp","model-context-protocol","nextjs","nodejs","open-source","streamable-http","typescript"],"latest_commit_sha":null,"homepage":"https://mcp.onkernel.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/onkernel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-15T18:29:11.000Z","updated_at":"2025-07-17T15:07:53.000Z","dependencies_parsed_at":"2025-07-17T20:57:41.921Z","dependency_job_id":"829cc0ed-9d35-4581-89d4-1991e46e40e4","html_url":"https://github.com/onkernel/kernel-mcp-server","commit_stats":null,"previous_names":["onkernel/kernel-mcp-server"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/onkernel/kernel-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onkernel%2Fkernel-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onkernel%2Fkernel-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onkernel%2Fkernel-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onkernel%2Fkernel-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/onkernel","download_url":"https://codeload.github.com/onkernel/kernel-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onkernel%2Fkernel-mcp-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265743071,"owners_count":23820967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","browser-automation","cloud-browser","devtool","headless-chromium","kernel","mcp","model-context-protocol","nextjs","nodejs","open-source","streamable-http","typescript"],"created_at":"2025-07-18T10:36:32.841Z","updated_at":"2025-07-18T10:36:35.386Z","avatar_url":"https://github.com/onkernel.png","language":"TypeScript","readme":"# Kernel MCP Server\n\n[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org/)\n[![Next.js](https://img.shields.io/badge/Next.js-15.3%2B-black.svg)](https://nextjs.org/)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides AI assistants with secure access to [Kernel platform](https://onkernel.com) tools and browser automation capabilities.\n\n🌐 **Use instantly** at `https://mcp.onkernel.com/mcp` — no installation required!\n\n## What is this?\n\nThe Kernel MCP Server bridges AI assistants (like Claude, Cursor, or other MCP-compatible tools) with the Kernel platform, enabling them to:\n\n- 🚀 Deploy and manage applications in the cloud\n- 🌐 Launch and control headless Chromium sessions for web automation\n- 📊 Monitor deployments and track invocations\n- 🔍 Search Kernel documentation and inject context\n- 💻 Evaluate JavaScript and stream DOM snapshots\n\n**Open-source \u0026 fully-managed** — the complete codebase is available here, and we run the production instance so you don't need to deploy anything.\n\nThe server uses OAuth 2.0 authentication via [Clerk](https://clerk.com) to ensure secure access to your Kernel resources.\n\n## 📋 Prerequisites\n\n- **Kernel Account**: Sign up at [onkernel.com](https://onkernel.com)\n\n## 🚀 Quick Start\n\nThe easiest way to get started is using our hosted service at `https://mcp.onkernel.com/mcp`. No installation or deployment required!\n\n### Claude\n\n#### Team \u0026 Enterprise (Claude.ai)\n\n1. Navigate to **Settings** in the sidebar (web or desktop).\n2. Scroll to **Integrations** and click **Add more**.\n3. Fill in:\n   - **Integration name:** `Kernel`\n   - **Integration URL:** `https://mcp.onkernel.com/mcp`\n4. Start a chat, enable **Tools**, and finish auth.\n\n#### Free \u0026 Pro (Claude desktop)\n\nOpen `~/Library/Application Support/Claude/claude_desktop_config.json` and add:\n\n```json\n{\n  \"mcpServers\": {\n    \"kernel\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.onkernel.com/mcp\"]\n    }\n  }\n}\n```\n\nRestart the Claude desktop app.\n\n#### Claude Code CLI\n\n```bash\nclaude mcp add --transport http kernel https://mcp.onkernel.com/mcp\n# then, inside the REPL:\n/mcp   # to run through auth\n```\n\n### Cursor\n\n[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=kernel\u0026config=eyJ1cmwiOiJodHRwczovL21jcC5vbmtlcm5lbC5jb20vbWNwIn0%3D)\n\n#### Manual Setup\n\n1. Press **⌘/Ctrl Shift J** to open settings.\n2. Click **Tools \u0026 Integrations**.\n3. Click **New MCP server**.\n4. Add the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"kernel\": {\n      \"url\": \"https://mcp.onkernel.com/mcp\"\n    }\n  }\n}\n```\n\n5. Save and the server will be available.\n\n### Goose\n\n[Add to Goose](goose://extension?cmd=npx\u0026arg=-y\u0026arg=mcp-remote\u0026arg=https%3A%2F%2Fmcp.onkernel.com%2Fmcp\u0026timeout=300\u0026id=kernel\u0026name=Kernel\u0026description=Access%20Kernel%27s%20cloud-based%20browsers%20via%20MCP)\n\n#### Goose Desktop\n\n1. Click `...` in the top right corner of the Goose Desktop.\n2. Select `Advanced Settings` from the menu.\n3. Under `Extensions`, click `Add custom extension`.\n4. On the `Add custom extension` modal, enter:\n   - **Type**: `Streaming HTTP`\n   - **ID**: `kernel`\n   - **Name**: `Kernel`\n   - **Description**: `Access Kernel's cloud-based browsers via MCP`\n   - **URL**: `https://mcp.onkernel.com/mcp`\n   - **Timeout**: `300`\n5. Click `Add` button.\n\n#### Goose CLI\n\n1. Run the following command:\n   ```bash\n   goose configure\n   ```\n2. Select `Add Extension` from the menu.\n3. Choose `Remote Extension (Streaming HTTP)`.\n4. Follow the prompts:\n   - **Extension name**: `Kernel`\n   - **URL**: `https://mcp.onkernel.com/mcp`\n   - **Timeout**: `300`\n\n### Visual Studio Code\n\n```json\n{\n  \"mcpServers\": {\n    \"kernel\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.onkernel.com/mcp\"]\n    }\n  }\n}\n```\n\n1. Press **⌘/Ctrl P** → search **MCP: Add Server**.\n2. Select **Command (stdio)**.\n3. Enter:\n   ```bash\n   npx -y mcp-remote https://mcp.onkernel.com/mcp\n   ```\n4. Name the server **Kernel** and press Enter.\n5. Activate via **MCP: List Servers → Kernel → Start Server**.\n\n### Windsurf\n\n1. Press **⌘/Ctrl ,** to open settings.\n2. Navigate **Cascade → MCP servers** → **Add custom server**.\n3. Paste:\n\n```json\n{\n  \"mcpServers\": {\n    \"kernel\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.onkernel.com/mcp\"]\n    }\n  }\n}\n```\n\n### Zed\n\nOpen `settings.json` and add:\n\n```json\n{\n  \"context_servers\": {\n    \"kernel\": {\n      \"command\": {\n        \"path\": \"npx\",\n        \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.onkernel.com/mcp\"],\n        \"env\": {}\n      },\n      \"settings\": {}\n    }\n  }\n}\n```\n\n### Others\n\nMany other MCP-capable tools accept:\n\n- **Command:** `npx`\n- **Arguments:** `-y mcp-remote https://mcp.onkernel.com/mcp`\n- **Environment:** _(none)_\n\nConfigure these values wherever the tool expects MCP server settings.\n\n## 🛠️ Available MCP Tools\n\nThe server provides these tools for AI assistants:\n\n### Application Management\n\n- `list_apps` - List applications in your Kernel workspace\n- `invoke_action` - Execute actions in Kernel applications\n- `get_deployment` - Get deployment status and logs\n- `list_deployments` - List all deployments\n- `get_invocation` - Get action invocation details\n\n### Browser Automation\n\n- `create_browser` - Launch a new browser session\n- `get_browser` - Get browser session information\n- `delete_browser` - Terminate a browser session\n- `list_browsers` - List active browser sessions\n\n### Documentation \u0026 Search\n\n- `search_docs` - Search Kernel platform documentation and guides\n\n## 📚 Usage Examples\n\n### Basic App Management\n\n```\nHuman: List my Kernel applications\nAssistant: I'll check your Kernel applications for you.\n[Uses list_apps tool]\n```\n\n### Browser Automation\n\n```\nHuman: Create a browser session and navigate to example.com\nAssistant: I'll create a browser session for you and navigate to example.com.\n[Uses create_browser and browser automation tools]\n```\n\n### Deployment Monitoring\n\n```\nHuman: Check the status of my latest deployment\nAssistant: Let me check your recent deployments and their status.\n[Uses list_deployments and get_deployment tools]\n```\n\n## ❓ Frequently Asked Questions\n\n**Is the server open source?**\nYes — the code lives at [github.com/onkernel/kernel-mcp-server](https://github.com/onkernel/kernel-mcp-server). You're welcome to browse the code and contribute. We provide a hosted instance at `https://mcp.onkernel.com/mcp` for convenience.\n\n**Does Kernel store my data?**\nOnly encrypted refresh tokens and minimal metadata required for auth; browser state lives in your Kernel workspace and never leaves your tenancy.\n\n**What scopes are requested?**\n`browser.session`, `dom.read`, and `js.eval` by default. You can narrow scopes in your client during OAuth.\n\n**What if the handshake fails?**\nRestart your MCP client or disable/re-enable the Kernel server before opening a support ticket. Most connection issues resolve with a simple restart.\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our contributing guidelines:\n\n1. **Fork the repository** and create your feature branch\n2. **Make your changes** and add tests if applicable\n3. **Run the linter and formatter**:\n   ```bash\n   npm run lint\n   npm run format\n   ```\n4. **Test your changes** thoroughly\n5. **Submit a pull request** with a clear description\n\n### Development Guidelines\n\n- Follow the existing code style and formatting\n- Add TypeScript types for new functions and components\n- Update documentation for any API changes\n- Ensure all tests pass before submitting\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🔗 Related Projects\n\n- [Model Context Protocol](https://modelcontextprotocol.io/) - The protocol specification\n- [Kernel Platform](https://onkernel.com) - The platform this server integrates with\n- [Clerk](https://clerk.com) - Authentication provider\n- [@onkernel/sdk](https://www.npmjs.com/package/@onkernel/sdk) - Kernel JavaScript SDK\n\n## 💬 Support\n\n- **Issues \u0026 Bugs**: [GitHub Issues](https://github.com/onkernel/kernel-mcp-server/issues)\n- **MCP Feedback**: [github.com/kernelxyz/mcp-feedback](https://github.com/kernelxyz/mcp-feedback)\n- **Documentation**: [Kernel Docs](https://docs.onkernel.com) • [MCP Setup Guide](https://docs.onkernel.com/mcp)\n- **Community**: [Kernel Discord](https://discord.gg/FBrveQRcud)\n\n---\n\nBuilt with ❤️ by the [Kernel Team](https://kernel.so)\n","funding_links":[],"categories":["Browser Automation","📦 Other"],"sub_categories":["Cloud Services"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonkernel%2Fkernel-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonkernel%2Fkernel-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonkernel%2Fkernel-mcp-server/lists"}