Kernel MCP Server

核心MCP服务器

 ](https://nodejs.org/)  ](https://smithery.ai/server/kernel)

A. 模型上下文协议（MCP） 为AI助手提供安全访问的服务器 内核平台 工具和浏览器自动化功能。

Architecture Overview

🌐 立即使用 在 https://mcp.onkernel.com/mcp --无需安装！

这是什么？

内核MCP服务器将AI助手（如Claude、Cursor或其他MCP兼容工具）与内核平台连接起来，使它们能够：

• 🚀 在云中部署和管理内核应用程序
• 🌐 启动和控制用于web自动化的无头Chromium会话
• 📊 监控部署并跟踪调用
• 🔍 搜索内核文档并注入上下文
• 💻 在实时浏览器上执行任意Playwright代码
• 🎥 自动录制浏览器自动化的视频回放

开源和完全管理 --完整的代码库可以在这里找到，我们运行生产实例，所以你不需要部署任何东西。

服务器通过以下方式使用OAuth 2.0身份验证 职员 以确保对内核资源的安全访问。

要更深入地了解我们为什么以及如何构建此服务器，请参阅我们的博客文章： 介绍内核MCP服务器.

安装说明

一般（运输）

• 流式HTTP（推荐）： https://mcp.onkernel.com/mcp
• stdio通过 mcp-remote （适用于没有远程MCP支持的客户端）： npx -y mcp-remote https://mcp.onkernel.com/mcp

在支持的地方使用可流式传输的HTTP端点，以提高可靠性。如果您的客户端不支持远程MCP，请使用 mcp-remote 超过stdio。

Kernel的服务器是一个集中托管的、经过身份验证的远程MCP，使用OAuth 2.1进行动态客户端注册。

使用Kernel CLI快速设置

配置MCP服务器的最快方法是使用 内核CLI:

# Install the CLI
brew install onkernel/tap/kernel
# or: npm install -g @onkernel/cli

# Install MCP for your tool
kernel mcp install --target 

支持的目标

CLI会自动定位工具的配置文件并添加Kernel MCP服务器配置。

连接您的客户端

克劳德

我们的远程MCP服务器与Claude的免费用户添加MCP服务器的方法不兼容。

Pro、Max、团队和企业（Claude.ai和Claude Desktop）

1. 首选 设置→ 连接器→ 添加自定义连接器.
2. 输入： 集成名称： Kernel, 集成URL: https://mcp.onkernel.com/mcp，然后单击 添加.
3. 在 设置→ 连接器，单击 连接 旁边 Kernel 启动OAuth并批准。
4. 在聊天中，单击 搜索和工具 并在需要时启用内核工具。

在Claude for Work（团队/企业）上，只有主所有者或所有者可以为组织启用自定义连接器。配置后，每个用户仍然需要转到 设置→ 连接器 然后单击 连接 为他们的账户授权。

克劳德代码CLI

claude mcp add --transport http kernel https://mcp.onkernel.com/mcp
# Then in the REPL run once to authenticate:
/mcp

光标

自动设置


手动设置

1. 按 ⌘/Ctrl Shift J.
2. 首选 MCP和集成→ 新建MCP服务器.
3. 添加此配置：

{
  "mcpServers": {
    "kernel": {
      "url": "https://mcp.onkernel.com/mcp"
    }
  }
}

1. 保存。服务器将出现在工具中。

开源代码

将以下内容添加到您的 ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "kernel": {
      "type": "remote",
      "url": "https://mcp.onkernel.com/mcp",
    },
  },
}

然后使用OpenCode CLI进行身份验证：

# Authenticate with Kernel
opencode mcp auth kernel

# If you need to re-authenticate, first logout then auth again
opencode mcp logout kernel
opencode mcp auth kernel

鹅

点击 这里 只需单击一下即可在Goose上安装Kernel。

鹅桌面

1. 点击 Extensions 在Goose Desktop的侧边栏中。
2. 点击 Add custom extension.
3. 在 Add custom extension 模态，输入：

- 扩展名: Kernel - 类型: STDIO - 描述: Access Kernel's cloud-based browsers via MCP - 命令: npx -y mcp-remote https://mcp.onkernel.com/mcp - 超时: 300

1. 点击 Save Changes 按钮。

Goose命令行界面

1. 运行以下命令：

   goose configure

1. 选择 Add Extension 从菜单上。
2. 选择 Command-line Extension.
3. 按照提示操作：

- 扩展名: Kernel - 命令: npx -y mcp-remote https://mcp.onkernel.com/mcp - 超时: 300 - 描述: Access Kernel's cloud-based browsers via MCP

Visual Studio Code

{
  "mcpServers": {
    "kernel": {
      "url": "https://mcp.onkernel.com/mcp",
      "type": "http"
    }
  }
}

1. 按 ⌘/Ctrl P → 搜索 MCP：添加服务器.
2. 选择 HTTP（HTTP或服务器发送事件）.
3. 输入： https://mcp.onkernel.com/mcp
4. 命名服务器 内核 → 进来。

帆板运动

1. 按 ⌘/Ctrl， 打开设置。
2. 导航 级联→ MCP服务器→ 查看原始配置.
3. 粘贴：

{
  "mcpServers": {
    "kernel": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
    }
  }
}

1. 开 管理MCP，单击 刷新 加载内核MCP。

泽德

1. 按 ⌘/Ctrl， 打开设置。
2. 粘贴：

{
  "context_servers": {
    "kernel": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
    }
  }
}

史密瑟里

您可以直接连接到 https://mcp.onkernel.com/mcp，或使用Smithery提供的URL作为代理。

• 在任何MCP客户端中使用Smithery URL：

1. 打开 Smithery：内核. 1. 从“获取连接URL”复制URL。 1. 将其粘贴到MCP客户端的“添加服务器”流程中。

• 在Smithery的Playground MCP客户端中使用Kernel：

1. 打开 Smithery游乐场. 1. 点击“添加服务器”，搜索“内核”，然后添加。 1. 出现提示时登录并授权内核。

其他

许多其他支持MCP的工具可以接受：

• 命令： npx
• 论据： -y mcp-remote https://mcp.onkernel.com/mcp

{
  "kernel": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.onkernel.com/mcp"]
  }
}

在工具需要MCP服务器设置的任何地方配置这些值。

工具（共10个）

每个内核功能都有一个 manage_* 工具与a action 参数，保持工具集小而一致。四个独立的工具处理高频工作流程。

manage\_\*工具

• manage_browsers -创建、列出、获取和删除浏览器会话。支持无头/隐形模式、配置文件、代理、视口、扩展和SSH隧道。
• manage_profiles -设置（带引导的实时浏览器会话）、列出和删除浏览器配置文件，以保存Cookie和登录信息。
• manage_browser_pools -创建、列出、获取、删除和刷新预热浏览器池。从池中获取和释放浏览器。
• manage_proxies -创建、列出和删除代理配置（数据中心、ISP、住宅、移动、自定义）。
• manage_extensions -列出并删除上传的浏览器扩展名。
• manage_apps -列出应用程序、调用操作、获取/列出部署和获取调用结果。

独立工具

• computer_action -浏览器会话的鼠标、键盘和屏幕截图控件（单击、键入、按键、滚动、移动、get_position、屏幕截图）。
• execute_playwright_code -在浏览器上执行Playwright/TypeScript代码，并自动播放和清理视频。
• exec_command -在浏览器虚拟机中运行shell命令。返回解码的stdout/stderr。
• search_docs -搜索内核平台文档和指南。

资源

• browsers:// -访问浏览器会话（列出所有会话或获取特定会话）
• browser_pools:// -访问浏览器池（列出所有或获取特定池）
• profiles:// -访问浏览器配置文件（列出所有或获取特定配置文件）
• apps:// -访问已部署的应用程序（列出所有应用程序或获取特定应用程序）

提示

• kernel-concepts -获取内核核心概念（浏览器、应用程序、概述）的解释
• debug-browser-session -获取全面的调试指南，以排除浏览器会话（VM问题、网络问题、Chrome错误）的故障

故障排除

• 光标清除重置：⌘/Ctrl Shift P→ run Cursor: Clear All MCP Tokens （重置所有MCP服务器和身份验证；重新启用内核并重新进行身份验证）。
• 清除已保存的身份验证并重试： rm -rf ~/.mcp-auth
• 使用时确保使用最新的Node.js版本 npx mcp-remote
• 如果在严格的网络后面，请尝试通过stdio mcp-remote，或明确设置客户端支持的传输

例子

从任何地方调用应用程序

Human: Run my web-scraper app to get data from reddit.com
Assistant: I'll execute your web-scraper action with reddit.com as the target.
[Uses invoke_action tool to run your deployed app in the cloud]

动态执行Playwright代码

Human: Go to example.com and get me the page title
Assistant: I'll execute Playwright code to navigate to the site and retrieve the title.
[Uses execute_playwright_code tool with code: "await page.goto('https://example.com'); return await page.title();"]
Returns: { success: true, result: "Example Domain", replay_url: "https://..." }

设置浏览器配置文件以进行身份验证

Human: Set up a profile for my work accounts
Assistant: I'll create a profile and guide you through the setup process.
[Uses setup_profile tool]

Human: I'm done setting up my accounts
Assistant: Perfect! I'll close the browser session and save your profile.
[Uses delete_browser tool to save profile]

调试浏览器会话

注： 附上 debug-browser-session 先提示您的对话，然后寻求调试帮助。

Human: [Attaches debug-browser-session prompt with session_id and issue_description]
       Help me debug this browser session.
Assistant: [Follows the debugging guide from the prompt: uses Kernel CLI to check session status,
            read VM logs, test network connectivity, and diagnose issues]

将本地开发服务器连接到云浏览器

这非常适合需要在真实浏览器中预览本地更改的AI编码工作流程：

Human: I'm working on a React app running on localhost:3000. I want to test it in a cloud browser.
Assistant: I'll create a browser tunnel session for you.
[Uses create_browser_tunnel tool with local_port: 3000]
Returns: Session ID, live view URL, and tunnel connection command.

🤝 贡献

我们欢迎捐款！请参阅我们的投稿指南：

1. 分叉存储库 并创建功能分支
2. 进行更改 并在适用的情况下添加测试
3. 运行linter和格式化程序:

   bun run lint
   bun run format

1. 测试您的更改 彻底地
2. 提交拉取请求 描述清晰

开发指南

• 遵循现有的代码样式和格式
• 为新函数和组件添加TypeScript类型
• 针对任何API更改更新文档
• 提交前确保所有测试通过

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🔗 相关项目

• 模型上下文协议 -协议规范
• 内核平台 -此服务器集成的平台
• 职员 -身份验证提供者
• @onkernel/sdk -内核JavaScript SDK

💬 支持

• 问题和Bug:
• MCP反馈:
• 文档: 内核文档 • MCP设置指南
• 社区: 内核不一致

______________________________________________________________________

建于❤️ 由 核心团队

在本地运行此服务器

cp .env .env.local # Values for the .env.local file are in 1Password > DevEnvVars > MCP section
bun install
bun run dev

这将启动端口3002上的服务器。