kernel-mcp-server

🚀 Kernel MCP Server

Kernel MCP Server 是一个 Model Context Protocol (MCP) 服务器，它为 AI 助手提供对 Kernel 平台 工具的安全访问权限和浏览器自动化功能。借助此服务器，AI 助手能够在云端部署和管理 Kernel 应用程序，还能启动并控制无头 Chromium 会话以实现网页自动化操作。

🌐 您可以直接在 https://mcp.onkernel.com/mcp 使用，无需进行安装！

🚀 快速开始

初次使用？从这里开始！

准备尝试 Kernel，但还没有看到任何应用程序？ 没问题！按照以下步骤开始：

步骤 1：安装 Kernel MCP Server

使用下面的 设置说明 将 Kernel MCP 服务器安装到您喜欢的 MCP 客户端。

步骤 2：向您的 AI 助手寻求帮助

连接后，只需在 MCP 客户端聊天中询问：

"How do I get a Kernel sample app set up locally?"

您的 AI 助手将使用 search_docs 工具为您获取最新的快速入门说明，并指导您设置第一个 Kernel 应用程序！

步骤 3：使用 MCP 工具进行部署和测试

在本地拥有示例应用程序后，询问您的助手：

"Deploy my sample app to Kernel"

注意： 请耐心等待，直到所有工具参数完全生成后再运行工具调用。

然后进行测试：

"Run my app and get the title from onkernel.com"

为什么采用这种方法？

• ✅ 始终保持最新 - 您的 AI 助手会获取最新的文档。
• ✅ 交互式指导 - 根据您的设置获得定制化帮助。
• ✅ 学习 MCP 工具 - 体验 search_docs、deploy_app 和 invoke_action 的强大功能。
• ✅ 端到端工作流程 - 从本地开发到云端部署再到执行。

您将体验到什么？

您的 AI 助手将帮助您：

• 下载并理解示例应用程序 (search_docs)
• 将您的本地代码部署到云端 (deploy_app)
• 运行操作并查看结果 (invoke_action)
• 在云端创建浏览器会话 (create_browser)
• 监控部署情况 (list_deployments, get_deployment)

✨ 主要特性

• 采用 OAuth 2.0 认证，通过 Clerk 确保对 Kernel 资源的安全访问。
• 提供应用程序管理、浏览器自动化和文档搜索等多种 MCP 工具，供 AI 助手使用。

📦 安装指南

MCP 服务器设置

首先，使用 https://mcp.onkernel.com/mcp 将 Kernel MCP 服务器添加到您喜欢的 MCP 兼容客户端。以下是流行客户端的设置说明：

Claude

团队版和企业版 (Claude.ai)

1. 在侧边栏（网页或桌面版）中导航到 设置。
2. 滚动到 集成 并点击 添加更多。
3. 填写：
   • 集成名称：Kernel
   • 集成 URL：https://mcp.onkernel.com/mcp
4. 开始聊天，启用 工具，并完成身份验证。

免费版和专业版 (Claude 桌面版)

打开 ~/Library/Application Support/Claude/claude_desktop_config.json 并添加：

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

重启 Claude 桌面应用程序。

Claude Code CLI

claude mcp add --transport http kernel https://mcp.onkernel.com/mcp
# 然后，在 REPL 中：
/mcp   # 进行身份验证

Cursor

添加到 Cursor

手动设置

1. 按下 ⌘/Ctrl Shift J 打开设置。
2. 点击 工具与集成。
3. 点击 新 MCP 服务器。
4. 添加以下配置：

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

5. 保存后，服务器将可用。

Goose

添加到 Goose

Goose 桌面版

1. 点击 Goose 桌面右上角的 ...。
2. 从菜单中选择 高级设置。
3. 在 扩展 下，点击 添加自定义扩展。
4. 在 添加自定义扩展 模态框中，输入：
   • 类型：Streaming HTTP
   • ID：kernel
   • 名称：Kernel
   • 描述：通过 MCP 访问 Kernel 的基于云的浏览器
   • URL：https://mcp.onkernel.com/mcp
   • 超时时间：300
5. 点击 添加 按钮。

Visual Studio Code

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

1. 按下 ⌘/Ctrl P → 搜索 MCP: 添加服务器。
2. 选择 命令 (stdio)。
3. 输入：

   npx -y mcp-remote https://mcp.onkernel.com/mcp
   

4. 将服务器命名为 Kernel 并按 Enter 键。
5. 通过 MCP: 列出服务器 → Kernel → 启动服务器 激活。

Windsurf

1. 按下 ⌘/Ctrl , 打开设置。
2. 导航到 级联 → MCP 服务器 → 添加自定义服务器。
3. 粘贴：

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

Zed

打开 settings.json 并添加：

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

其他工具

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

• 命令：npx
• 参数：-y mcp-remote https://mcp.onkernel.com/mcp
• 环境：(无) 在工具期望 MCP 服务器设置的地方配置这些值。

💻 使用示例

基础用法

将本地应用程序部署到云端

Human: I have a Kernel Playwright automation script open in my editor. Can you deploy it to Kernel?
Assistant: I'll read your local files and deploy them to Kernel for you.
[Uses deploy_app tool to upload your code and create a cloud deployment]

从任何地方调用应用程序

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]

创建持久化浏览器会话

Human: Create a stealth browser session that I can reuse for testing login flows
Assistant: I'll create a persistent, stealth-enabled browser that maintains state between uses.
[Uses create_browser tool with persistence and stealth options]

🛠️ 可用的 MCP 工具

应用程序管理

• deploy_app - 将 TypeScript 或 Python 应用程序部署到 Kernel
• list_apps - 列出您的 Kernel 组织中的应用程序
• invoke_action - 在 Kernel 应用程序中执行操作
• get_deployment - 获取部署状态和日志
• list_deployments - 列出所有部署
• get_invocation - 获取操作调用详情

浏览器自动化

• create_browser - 启动新的浏览器会话
• get_browser - 获取浏览器会话信息
• delete_browser - 终止浏览器会话
• list_browsers - 列出活动的浏览器会话

文档与搜索

• search_docs - 搜索 Kernel 平台文档和指南

❓ 常见问题解答

服务器是开源的吗？ 是的 — 代码位于 github.com/onkernel/kernel-mcp-server。欢迎浏览代码并贡献代码。为了方便起见，我们在 https://mcp.onkernel.com/mcp 提供了一个托管实例。

Kernel 会存储我的数据吗？ 仅存储加密的刷新令牌和认证所需的最少元数据；浏览器状态存储在您的 Kernel 组织中，不会离开您的租户。

如果握手失败怎么办？ 在提交支持工单之前，重启您的 MCP 客户端或禁用/重新启用 Kernel 服务器。大多数连接问题通过简单的重启即可解决。

🤝 贡献代码

我们欢迎贡献！请查看我们的贡献指南：

1. 分叉仓库 并创建您的功能分支。
2. 进行更改，并在适用的情况下添加测试。
3. 运行代码检查器和格式化工具：

   bun run lint
   bun run format
   

4. 彻底测试您的更改。
5. 提交拉取请求，并提供清晰的描述。

开发指南

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

📄 许可证

本项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

🔗 相关项目

• Model Context Protocol - 协议规范
• Kernel 平台 - 此服务器集成的平台
• Clerk - 认证提供商
• @onkernel/sdk - Kernel JavaScript SDK

💬 支持

• 问题与漏洞：GitHub Issues
• MCP 反馈：github.com/kernelxyz/mcp-feedback
• 文档：Kernel 文档 • MCP 设置指南
• 社区：Kernel Discord

由 Kernel 团队 用心打造