Playwright-server MCP服务器

\一个集成Playwright工具的MCP服务器\

组件

资源

该服务器实现了一个简单的笔记存储系统，包含：

• 自定义note:// URI方案用于访问单个笔记
• 每个笔记资源都有名称、描述和text/plain MIME类型

提示词

服务器提供以下提示词：

• summarize-notes：创建所有存储笔记的摘要
  • 可选"style"参数控制详细程度（简要/详细）
  • 生成结合所有当前笔记与风格偏好的提示词

工具

服务器实现以下工具：

• playwright_navigate：导航到指定URL。如果当前没有活动会话，此操作将自动创建新会话。
  • 需要url参数（字符串）。
• playwright_screenshot：截取当前页面或特定元素的屏幕截图。
  • 需要screenshot参数（字符串）作为截图文件名。
  • 可选selector参数（字符串）指定要截图元素的CSS选择器。如果未提供选择器，则截取整个页面。
• playwright_click：使用CSS选择器点击页面上的元素。
  • 需要selector参数（字符串）指定要点击元素的CSS选择器。
• playwright_fill：填写输入字段。
  • 需要selector参数（字符串）指定输入字段的CSS选择器。
  • 需要value参数（字符串）指定要填写的值。
• playwright_evaluate：在浏览器控制台执行JavaScript代码。
  • 需要script参数（字符串）指定要执行的JavaScript代码。
• playwright_click_text：通过文本内容点击页面上的元素。
  • 需要text参数（字符串）指定要点击元素的文本内容。
• playwright_get_text_content：获取所有可见元素的文本内容。
• playwright_get_html_content：获取页面的HTML内容。
  • 需要selector参数（字符串）指定元素的CSS选择器。

配置

[TODO：添加特定于您实现的配置详情]

快速入门

安装

Claude桌面版

MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows：%APPDATA%/Claude/claude_desktop_config.json

开发

构建与发布

为分发准备包：

1. 同步依赖并更新锁定文件：

uv sync

2. 构建包分发版：

uv build

这将在dist/目录中创建源代码和wheel分发版。

3. 发布到PyPI：

uv publish

注意：您需要通过环境变量或命令行标志设置PyPI凭据：

• 令牌：--token或UV_PUBLISH_TOKEN
• 或用户名/密码：--username/UV_PUBLISH_USERNAME和--password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过stdio运行，调试可能具有挑战性。为了获得最佳调试体验，我们强烈建议使用MCP Inspector。

您可以通过npm使用以下命令启动MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory C:\Users\YUNYING\Documents\project\python\mcp\playwright-server run playwright-server

启动后，Inspector将显示一个URL，您可以在浏览器中访问该URL开始调试。