使用说明(Markdown 结构,便于快速上手)
-
项目简介
- 该仓库整合了基于 MCP 的后端服务器实现,旨在为 LLM 客户端提供标准化的资源访问、工具执行与提示渲染能力。核心包含持续化的 Python 解释环境、浏览器自动化工具以及相关的 HTTP 桥接接口,供 LLM 客户端通过 MCP 协议进行上下文服务调用。
-
主要功能点
- 持久化的 Python 解释环境:提供 execute、reset、list_vars 等工具,实现跨调用的环境状态与变量持久化。 带有自动安装缺失依赖的能力,方便在运行时按需安装 Python 包。
- 浏览器自动化 MCP:基于 Playwright/Selenium 的浏览器控制,支持导航、页面文本/HTML提取、资源下载、快照导出、网络性能数据采集、以及复杂的网页交互工具集(点击、输入、截图、JS执行等)。
- 资源与网络数据:能够捕获页面资源、导出 HAR、获取资源 timings、网络 idle 等,便于对页面行为进行分析。
- HTTP 桥接界面:FastAPI HTTP bridge 与 Unix Socket 的组合,提供直观的 HTTP 接口来执行 Python 代码等操作,方便跨进程调用。
- Hook 与会话管理:集成 Claude Code 的会话阶段钩子,用于跟踪会话、崩溃检测和会话元数据整理。
-
安装步骤
- 全局安装 MCP 服务器(用户作用域)
- README 提供了通过 uvx 方式从 GitHub 安装子目录下的 MCP 服务器的方法,,以及在本地克隆后直接运行 server 的示例流程。
- 具体服务器举例:
- Python Interpreter MCP
- 从 GitHub 获取并安装到用户作用域,/mcp/python-interpreter
- 本地克隆运行示例:uv run --project ~/claude-workspace/mcp/python-interpreter --script ~/claude-workspace/mcp/python-interpreter/server.py
- Browser Automation MCP
- 从 GitHub 获取并安装到用户作用域,/mcp/browser-automation
- 本地克隆运行示例:uv run --project ~/claude-workspace/mcp/browser-automation --script ~/claude-workspace/mcp/browser-automation/server.py
- Selenium Browser Automation MCP
- 从 GitHub 获取并安装到用户作用域,/mcp/selenium-browser-automation
- 本地克隆运行示例:uv run --project ~/claude-workspace/mcp/selenium-browser-automation --script ~/claude-workspace/mcp/selenium-browser-automation/server.py
- Python Interpreter MCP
- 全局安装 MCP 服务器(用户作用域)
-
服务器配置(MCP 客户端需要的启动信息) 下面给出与仓库结构对应的准确配置信息示例(JSON 格式,包含 server name、command、args 等;仅用于 MCP 客户端使用,不是代码实现)。请把以下内容作为配置输入给 MCP 客户端,确保服务器能够启动并被客户端发现。
{ "server_name": "python-interpreter", "command": "uv", "args": [ "run", "--project", "/path/to/claude-workspace/mcp/python-interpreter", "--script", "/path/to/claude-workspace/mcp/python-interpreter/server.py" ], "notes": "启动 Python 解释环境 MCP,使用 uv run 运行 server.py,保持持久作用域。" }
{ "server_name": "browser-automation", "command": "uv", "args": [ "run", "--project", "/path/to/claude-workspace/mcp/browser-automation", "--script", "/path/to/claude-workspace/mcp/browser-automation/server.py" ], "notes": "启动浏览器自动化 MCP,基于 Playwright/Selenium 的浏览器控制。" }
{ "server_name": "selenium-browser-automation", "command": "uv", "args": [ "run", "--project", "/path/to/claude-workspace/mcp/selenium-browser-automation", "--script", "/path/to/claude-workspace/mcp/selenium-browser-automation/server.py" ], "notes": "启动 Selenium 浏览器自动化 MCP,提供复杂的浏览器交互与网络捕获能力。" }
-
基本使用方法
- 启动服务器后,客户端通过 MCP 协议对这些服务器发起请求,执行工具、获取资源及输出结果。常用操作包括:
- 使用 Python Interpreter MCP 执行代码片段、查看变量等,保持跨调用的会话状态。
- 使用 Browser Automation MCP 完成网页导航、文本提取、截图、资源下载、网络分析等任务。
- 通过 HTTP 桥接接口,使用 /execute 端点等实现对后端服务的直接调用与数据获取。
- 常见注意点
- 自动安装缺失的 Python 包,以保证代码执行无中断。
- 对于浏览器自动化,确保本地环境具备所需浏览器驱动(如 Playwright/Chromium、Chrome/Chromium 等)。
- 注意安全性,执行的代码会在受控的执行环境中运行,避免将未经过滤的输入暴露给不可信来源。
- 启动服务器后,客户端通过 MCP 协议对这些服务器发起请求,执行工具、获取资源及输出结果。常用操作包括:
-
基本注意事项
- MCP 服务器在本仓库中以标准化的方式实现了工具暴露、会话生命周期管理、以及跨进程通信能力,具备运行时自适应和扩展能力。
- 客户端配置与启动命令请按上述 JSON 配置进行设置,确保服务器名称、启动命令与参数路径正确指向实际部署环境。
信息
分类
AI与计算