Loading...

文章背景图

本机 MCP 索引与调用说明

2026-03-18
0
- 字
- 分钟
|

我的 MCP

本文档列出当前可用的 MCP 服务器及其工具,供 AI Agent 直接调用。
安装已由用户完成,以下仅说明如何使用。

完整分类介绍

MCP 服务器 核心用途
CodeGraph 项目代码索引、符号搜索、调用链分析、变更影响评估
Playwright MCP 浏览器自动化:页面操控、截图、PDF生成、网络拦截、自动化测试

一、CodeGraph——代码分析

常用查询命令

在项目根目录下执行:

# 查看索引状态与统计
codegraph status

# 浏览文件树
codegraph files [路径]

# 搜索符号(函数、类、变量等)
codegraph query <关键词>   # 可选 --kind 限定类型,--limit 限制条数

# 调用关系
codegraph callers <符号>   # 谁调用了该符号
codegraph callees <符号>   # 该符号调用了谁

# 修改影响分析
codegraph impact <符号>    # 修改该符号会波及哪些文件

# 基于 Git 变更的影响筛查
git diff --name-only | codegraph affected --stdin

索引维护

codegraph sync              # 增量同步,更新变更文件
codegraph index --force     # 强制全量重建索引

AI 调用提示:当需要理解项目结构、查找定义/引用、评估改动风险时,优先使用上述命令获取精准上下文。

二、Playwright MCP——浏览器自动化

核心工具(已默认启用)

工具 功能
browser_navigate 导航到指定 URL
browser_click 点击页面元素
browser_type 在输入框内输入文本
browser_snapshot 获取页面无障碍树快照(轻量结构化内容)
browser_take_screenshot 截取页面截图
browser_evaluate 执行任意 JavaScript
browser_run_code 生成并运行 Playwright 代码片段

可选能力(通过 --caps 按需启用)

能力参数 新增工具 / 效果
vision 支持基于坐标的点击、滚动(视觉定位)
pdf 新增 browser_pdf 工具,导出页面为 PDF
network 拦截、修改网络请求与响应
storage 管理 cookies、localStorage、indexedDB
testing 提供 expect 风格断言,支持自动化测试
devtools 暴露 Chrome DevTools Protocol 网络操作

启用示例:

{
  "mcpServers": {
    "playwright": {
      "args": ["@playwright/mcp@latest", "--caps=vision,pdf,network"]
    }
  }
}

会话模式

  • 默认持久化:浏览器保持登录态,数据存储在用户目录。
  • 隔离模式(--isolated):每次关闭浏览器后清空存储,适合测试场景。
  • 连接已有浏览器(--extension):复用已打开的标签页。

AI 调用提示:所有浏览器操作均通过 MCP 工具完成,无需手动编写 Playwright 脚本。
如需要可视化反馈,使用 browser_take_screenshot;需要结构化页面内容,使用 browser_snapshot。

用途总结

MCP 使用场景
CodeGraph 理解项目架构、查找代码引用、分析改动影响、辅助 Code Review
Playwright MCP 操控浏览器完成网页操作、信息抓取、UI截图、自动化测试、PDF生成

结合二者,AI Agent 可完成“理解代码 → 操作浏览器验证”的全流程工作。

原创

本机 MCP 索引与调用说明

本文链接: 本机 MCP 索引与调用说明

本文采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

评论交流

文章目录