MCP Shark Viewer (VS Code / Cursor)
Inspect MCP traffic inside your IDE. Start/stop MCP Shark, open the inspector, and embed the MCP Shark UI in a webview.
目录
关于
此扩展集成 MCP鲨鱼 进入 VS代码/光标 （以及其他与VS Code兼容的IDE）。它提供：
- 侧边栏视图（活动栏），用于快速访问检查器
- 从命令面板启动/停止MCP Shark的命令
- 嵌入式MCP Shark UI面板（webview iframe）
特性
- 交通检查员视图：活动栏视图
Traffic Inspector(mcp-shark-traffic). - 嵌入式用户界面：用于iframe MCP Shark UI的Webview面板(
http://localhost:9853). - 服务器生命周期：从IDE内部启动/停止MCP Shark。
- 获取设置：当MCP Shark可用时，分机呼叫
GET /api/settings（API参考： GET/api/设置).
命令
| 命令 | 调色板标题 |
|---|---|
mcp-shark.viewer.startServer | 启动MCP Shark服务器 |
mcp-shark.viewer.stopServer | 停止MCP Shark服务器 |
mcp-shark.viewer.openInspector | 开放式交通检查员 |
mcp-shark.viewer.showDatabasePanel | MCP鲨鱼交通检查员 |
mcp-shark.viewer.refresh | 刷新 |
入门指南
- 打开活动栏→ MCP鲨鱼 → 交通检查员
- 跑 启动MCP Shark服务器 （命令面板）
- 跑 开放式交通检查员 打开嵌入式UI面板
- 在MCP Shark用户界面中，转到 MCP服务器设置 和 启动MCP服务器 （选择IDE配置/服务器，然后单击 启动MCP Shark)
- 有关MCP Shark首次运行+设置的完整说明，请参阅： 入门指南
- 有关MCP Shark安装/CLI的用法，请参阅上游README： mcp-shark/mcp-shark自述
需求
- 集成开发环境：VS代码/光标
- Node.js：如果您想通过扩展程序自动启动MCP Shark，则需要
npx -y @mcp-shark/mcp-shark（MCP Shark需要Node 18+；请参阅上游自述： mcp-shark/mcp-shark自述)
安装（VSIX）
包裹：
vsce package
# or:
# npx @vscode/vsce package安装到游标/VS代码中：
cursor --install-extension mcp-shark-viewer-for-vscode-0.0.1.vsix
code --install-extension mcp-shark-viewer-for-vscode-0.0.1.vsix另请参见： docs/How.md.
故障排除
- UI打开，但服务器未“运行”：即使外部MCP服务器无法启动，MCP Shark的UI也可以启动。打开MCP Shark UI并检查设置/日志（上游文档： mcp鲨鱼).
- 端口已在使用中（9853）：另一个MCP Shark实例（或其他进程）已绑定到
9853。请停止并重试。 - IDE内部启动失败：确保
npx在IDE环境中可用，您可以运行npx -y @mcp-shark/mcp-shark在终端中。
发展
- 在VS代码/光标中打开此仓库
- 按 F5 启动一个 扩展开发主机
- 运行：
- npm run validate - npm run lint
脚本
- 验证:
npm run validate（跑步node scripts/validate.js) - 棉绒:
npm run lint（生物特征） - 格式:
npm run format - 检查:
npm run check
文档
- 安装/打包:
docs/How.md - 验证工作流程:
docs/VALIDATION_PLAN.md
回购布局
- 根入口点:
extension.js（薄垫片出口自src/) - 源:
src/ - 验证器:
scripts/validate.js - 文档:
docs/ - Webview资产:
media/（例如。media/image.png)
许可证
看 LICENSE.