Skip to content

MCP 集成概述

TestNet 实现了 MCP(Model Context Protocol) 协议,允许 Claude Code、Cursor、Codex 等 AI 助手直接调用 TestNet 平台的能力。

MCP 是什么?

MCP 是 Anthropic 发布的开放标准协议,用于 AI 助手与外部系统的集成。通过 MCP,AI 助手可以:

  • 调用工具(Tools):执行资产查询、工作流执行等操作
  • 访问资源(Resources):读取项目列表、工作流列表等数据
  • 使用提示词(Prompts):使用预定义的 Prompt 模板

TestNet 提供的 MCP 能力

8 个 MCP 工具

工具名称功能
testnet_query_assets查询资产列表
testnet_get_asset_detail获取资产详情
testnet_run_workflow执行工作流
testnet_list_workflows列出可用工作流
testnet_list_tools列出可用工具
testnet_run_tool执行单个工具
testnet_get_task_status查询任务状态
testnet_list_projects列出所有项目

3 个 MCP 资源

资源 URI内容
testnet://projects项目列表
testnet://workflows工作流列表
testnet://tools工具列表

5 个 MCP 提示词模板

提示词名称功能
asset_inventory_summary资产盘点摘要
workflow_selector工作流推荐选择器
vul_triage漏洞分级与处置建议
recon_plan资产侦察计划生成
mock_test_guideMock 测试编写指导

详见 MCP 提示词模板


使用场景示例

场景 1:AI 助手辅助资产盘点

用户: 帮我查询项目 proj_001 下的子域名

Claude: 我来调用 TestNet 查询...
[调用 testnet_query_assets(projectId="proj_001", assetType="sub_domain")]

找到 15 个子域名:
- api.example.com
- www.example.com
...

场景 2:AI 助手触发安全扫描

用户: 对 example.com 执行域名侦察工作流

Claude: 好的,我来执行工作流...
[调用 testnet_run_workflow(workflowId="domain-recon-pipeline", target="example.com", assetType="DOMAIN")]

工作流已启动

MCP 端点

TestNet MCP 服务端点:

端点方法说明
/mcp/v1/toolsGET获取工具定义列表
/mcp/v1/tools/callPOST调用工具
/mcp/v1/resourcesGET获取资源列表
/mcp/v1/resources/readGET读取资源内容
/mcp/v1/promptsGET获取提示词列表
/mcp/v1/prompts/getPOST获取提示词渲染内容

相关文档

基于 MIT 协议发布