剧作家 MCP 服务器

English |日语

该项目是一个使用模型上下文协议 (MCP) 提供 Playwright 网页内容检索功能的服务器。

特征

• 页面导航

• 整页内容检索

• 可见内容检索

• 交互元素检测

• 鼠标操作模拟

• 用于测试的回显功能

Related MCP server: Puppeteer MCP Server

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Playwright MCP 服务器：

npx -y @smithery/cli install @showfive/playwright-mcp-server --client claude

手动安装

npm install

用法

启动服务器

npm run build
npm start

MCP 工具

可以使用以下工具：

1. navigate

   • 导航到指定的 URL

   • 参数： { url: string }

   • 返回：导航结果

2. get_all_content

   • 检索整个页面的内容

   • 参数：无

   • 返回：页面的所有文本内容

3. get_visible_content

   • 检索当前可见的内容

   • 参数： { minVisiblePercentage?: number }

   • 返回：可见的文本内容

4. get_interactive_elements

   • 获取页面上交互元素（按钮、链接等）的位置信息

   • 参数：无

   • 返回：交互元素的坐标和边界信息

5. move_mouse

   • 移动鼠标到指定坐标

   • 参数： { x: number, y: number }

   • 返回：运算结果

6. mouse_click

   • 在指定坐标处执行鼠标点击

   • 参数： { x: number, y: number, button?: "left" | "right" | "middle", clickCount?: number }

   • 返回：点击操作结果

7. mouse_wheel

   • 执行鼠标滚轮滚动

   • 参数： { deltaY: number, deltaX?: number }

   • 返回：滚动操作结果

8. drag_and_drop

   • 执行拖放操作

   • 参数： { sourceX: number, sourceY: number, targetX: number, targetY: number }

   • 返回：拖放操作结果

9. echo

   • 用于测试的 Echo 工具

   • 参数： { message: string }

   • 返回：已发送消息

发展

运行测试

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Generate coverage report
npm run test:coverage

测试结构

• tools/*.test.ts ：每个工具的功能测试

• mcp-server.test.ts ：MCP 服务器功能测试

实现特点

1. 内容检索

   • 整页内容检索

   • 仅检索可见内容

   • 正确的 HTML 解析

2. 相互作用

   • 交互元素的检测和位置信息检索

   • 鼠标操作模拟（移动、点击、滚动）

   • 拖放支持

3. 错误处理

   • 正确的导航错误处理

   • 超时处理

   • 无效 URL 检测

4. 配置灵活性

   • 无头/有头模式选择

   • 自定义用户代理

   • 视口大小设置

重要提示

• 确保在使用 MCP 服务器之前设置必要的环境变量

• 检索网页内容时遵循目标网站的服务条款

• 发送多个请求时保持适当的间隔

• 执行鼠标操作时，保持适当的间隔，以模拟实际的用户交互

执照

国际学习中心