项目简介

MCPKit 是一个创新的命令行工具，旨在简化 Model Context Protocol (MCP) 服务器的创建过程。它利用先进的 AI 技术智能探索并分析任何网站，然后自动生成一个功能完备的 TypeScript MCP 服务器。这些生成的服务器可以无缝集成到支持 MCP 协议的客户端（如 Claude Code 或 Claude Desktop），作为 LLM 的强大工具。通过这种方式，LLM 能够直接执行复杂的网页浏览、数据提取、表单填写、内容发布等任务，实现与网页的深度交互和自动化。

主要功能点

AI驱动的MCP服务器自动生成: 仅需提供一个网站 URL，MCPKit 即可智能分析网站结构，识别用户可执行的关键操作（如搜索、提交、导航、数据读取、内容创建），并自动生成高质量的 TypeScript 代码实现 MCP 服务器。
高级浏览器自动化能力: 生成的 MCP 服务器集成了 Browserbase 的 Stagehand 库，允许 LLM 通过自然语言指令对真实浏览器进行精确操作，例如点击按钮、输入文本、滚动页面、提取结构化信息等，实现端到端的网页自动化。
持久化会话管理: 支持保存和重用浏览器会话（Context ID），这意味着用户登录状态、购物车信息和浏览器设置可以在不同次运行中保持不变，无需重复登录或重新配置，极大地提升了自动化效率。
高度可定制与扩展: 生成的代码是可读性高、结构清晰的 TypeScript，用户可以根据具体业务需求轻松地进一步定制和扩展工具集，以适应更复杂的自动化场景。
多模型兼容: 生成的 MCP 服务器兼容多种主流 AI 模型（如 OpenAI、Anthropic、Google Generative AI、xAI），作为 Stagehand 浏览器自动化层的底层智能驱动，确保灵活性和性能。

安装步骤

在开始使用 MCPKit 之前，请确保您的系统已安装 Node.js 和 npm。

全局安装 MCPKit CLI 工具: 打开您的终端或命令行界面，运行以下命令进行安装：

npm install -g @kevinoconnell/mcpkit

配置密钥信息: MCPKit 及其生成的服务器需要访问 Browserbase 和 AI 模型的 API。运行以下命令，并按照提示输入您的密钥信息。这些密钥将被安全地存储在您的用户主目录下的 '~/.mcpkit/.env' 文件中。
```
mcpkit secrets
```
- 提示: 如果您尚未拥有 Browserbase 账户，请访问 Browserbase 官网注册并获取您的 API 密钥和 Project ID。AI 模型的 API 密钥（例如 Google Gemini 或 OpenAI API Key）也需提前准备。

服务器配置 (供MCP客户端使用)

MCPKit 生成的服务器旨在作为插件与支持 Model Context Protocol 的客户端（如 Claude Code 或 Claude Desktop）配合使用。以下是一个示例配置，展示如何将 MCPKit 生成的服务器集成到您的 MCP 客户端中。

重要提示:

MCPKit CLI 工具本身是一个生成器。您需要先运行 'mcpkit create <网站URL>' 来生成服务器项目。
在客户端配置前，请务必进入生成的服务器项目目录（例如 '您的项目名称_mcp_server'），运行 'npm install' 安装依赖，然后运行 'npm run build' 进行编译。生成的 MCP 服务器的可执行文件位于 'dist/index.js'。

MCP 客户端配置示例 (JSON 格式):

假设您为 'https://example.com' 生成了一个 MCP 服务器，其本地路径为 '/absolute/path/to/example_com_mcp_server'，且在生成时自动命名为 'example_com'。

{
  "mcpServers": {
    "您的服务器名称": {
      "command": "node",
      "args": [
        "/absolute/path/to/dist/index.js"
        // 请将此路径替换为您的 MCP 服务器项目下 'dist/index.js' 文件的绝对路径。
        // 例如：对于 MacOS/Linux，可能是 "/Users/您的用户名/您的项目目录/example_com_mcp_server/dist/index.js"
        // 对于 Windows，可能是 "C:\\Users\\您的用户名\\您的项目目录\\example_com_mcp_server\\dist\\index.js"
      ],
      "env": {
        // 以下环境变量通常已在您运行 'mcpkit secrets' 时自动配置到服务器的 '.env' 文件中。
        // 但某些 MCP 客户端可能要求在此处显式声明，请根据客户端要求决定是否填写。
        "BROWSERBASE_PROJECT_ID": "您的Browserbase项目ID",
        "BROWSERBASE_API_KEY": "您的Browserbase API密钥",
        "MODEL_API_KEY": "您的AI模型API密钥",
        "MODEL_PROVIDER": "您的AI模型提供商，例如 google/gemini-2.5-flash"
        // 可选：如果您希望服务器重用特定的浏览器会话（例如已登录状态），
        // 可以通过 'mcpkit contexts show <域名>' 获取 Context ID，并在此处添加：
        // "BROWSERBASE_CONTEXT_ID": "您的Browserbase会话Context ID"
      }
    }
  }
}

注意:

'您的服务器名称' 应该与 MCPKit 生成服务器时使用的域名（例如 'news_ycombinator_com'）相对应。
请务必替换示例路径为您的实际文件路径。

基本使用方法

创建 MCP 服务器: 运行 'mcpkit create <网站URL>' 命令来为指定网站生成 MCP 服务器。
```
mcpkit create https://news.ycombinator.com
# 或者，运行交互式模式：
mcpkit create
```
在生成过程中，MCPKit 会尝试打开一个浏览器窗口，提示您手动登录目标网站。这是为了捕获您的登录会话，以便生成的服务器能够访问受保护或需要认证的内容。完成登录后，返回终端并按 Enter 键继续。

管理浏览器会话上下文: 您可以使用 'mcpkit contexts' 命令来管理已保存的浏览器会话上下文（Context ID）。这些上下文允许您在不重复登录的情况下重用浏览器会话。

mcpkit contexts list            # 列出所有已保存的会话上下文
mcpkit contexts show github.com # 显示特定网站（例如 github.com）的会话上下文详情
mcpkit contexts delete mcpkit.sh # 删除特定网站（例如 mcpkit.sh）的会话上下文
mcpkit contexts create example.com # 为特定网站手动创建新的会话上下文

启动生成的 MCP 服务器: 进入您通过 'mcpkit create' 命令生成的服务器项目目录（例如 'news_ycombinator_com_mcp_server'），然后安装依赖并启动服务器：
```
cd news_ycombinator_com_mcp_server
npm install
npm run build # 编译 TypeScript 代码
npm start     # 启动 MCP 服务器
```
服务器启动后，会在控制台输出一个实时视图（Live View）URL。您可以通过该 URL 在浏览器中实时查看 Stagehand 浏览器自动化过程，这对于调试和理解服务器行为非常有用。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (供MCP客户端使用)

基本使用方法

信息