使用说明

项目简介

Kernel MCP Server 是一个基于 MCP（Model Context Protocol）的后端服务，向大语言模型客户端提供标准化的上下文资源、可调用的工具、以及可渲染的提示模板。它与 Kernel 平台深度整合，支持云端浏览器自动化、应用执行以及文档/资源的查询与协作，且通过 Clerk 提供安全认证与授权。

主要功能点

资源管理：提供 profiles、browsers、apps 等资源的读取、列举与查询
工具与 Prompts：内置多种工具（如浏览器管理、应用调用、文档搜索等）与提示模板
MCP 支持的传输与渲染：支持通过流式 HTTP、stdio 等传输方式，与客户端进行 JSON-RPC 风格交互
认证与授权：通过 Clerk 的 OAuth2 机制实现对资源的安全访问与会话管理
端到端集成：可与 Kernel 平台的浏览器自动化、视频回放、代理等能力无缝协作
安全会话与凭证管理：包括对令牌、 org_id、refresh_token 的映射及 TTL 管理

安装步骤

克隆并进入项目目录
安装依赖（如 bun、node/yarn/npm 版本见项目要求）
复制并配置环境变量 (.env.local)，确保所需的 KEY/URL 和 Clerk 配置就绪
启动开发服务器（本地运行示例：bun run dev），默认在端口 3002 提供服务
通过 MCP 客户端连接到远端 MCP 服务，端点通常为：https://mcp.onkernel.com/mcp

服务器配置（MCP 客户端所需的配置对象）

MCP 客户端需要的配置通常以 JSON 对象形式提供，包含 server name、command、args 等字段，用以描述如何在本地或云端启动并连接到 MCP 服务器。示例字段如下（请根据实际环境填充，客户端不需要额外的服务器实现细节）： { "server_name": "Kernel MCP Server", "command": "bun", "args": ["run", "dev"], "notes": "本服务器在端口 3002 启动，MCP 远端端点为 https://mcp.onkernel.com/mcp" } 说明：

server_name：用于标识 MCP 服务器的名称
command：启动服务器所需的命令
args：启动命令的参数列表
notes/描述字段：附加说明与端点信息，方便客户端了解连接方式与环境该配置旨在帮助 MCP 客户端知道如何启动与连接服务器，实际运行与部署细节以本仓库的环境变量与部署方式为准。

基本使用方法

启动本地开发环境，确保依赖已安装并配置好环境变量
使用 MCP 客户端（如 mcp-remote、浏览器集成插件等）连接到远端 MCP 端点 https://mcp.onkernel.com/mcp
通过工具和资源调用实现资源读取、浏览器控制、应用执行等
根据需要使用 Prompts 进行上下文说明与对话
如遇权限/授权问题，请按照 Clerk 的流程完成认证及授权

Kernel MCP Server