mcp-tool-discovery

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MCP Tool Discovery Guide

MCP工具发现指南

Snow-Flow provides 400+ tools via MCP (Model Context Protocol) servers. Tools are lazy-loaded to save tokens - use

tool_search

to discover them.

Snow-Flow通过MCP（Model Context Protocol）服务器提供400+种工具。工具采用延迟加载（lazy-loaded）机制以节省token - 使用

tool_search

来发现它们。

Quick Start

快速开始

javascript

// Find tools for a specific task
tool_search({ query: "incident" })      // ServiceNow incidents
tool_search({ query: "widget" })        // Widget development
tool_search({ query: "update set" })    // Update Set management
tool_search({ query: "cmdb" })          // CMDB operations

javascript

// 查找特定任务的工具
tool_search({ query: "incident" })      // ServiceNow事件
tool_search({ query: "widget" })        // 组件开发
tool_search({ query: "update set" })    // 更新集管理
tool_search({ query: "cmdb" })          // 配置管理数据库（CMDB）操作

Tool Categories

工具分类

ServiceNow Core Operations

ServiceNow核心操作

Query	Tools Found
`"incident"`	Incident CRUD, metrics, SLA
`"change"`	Change requests, CAB, risk
`"problem"`	Problem management, known errors
`"cmdb"`	CI search, relationships, discovery
`"user lookup"`	User/group queries
`"query table"`	Universal table queries

查询语句	找到的工具
`"incident"`	事件CRUD、指标、SLA
`"change"`	变更请求、变更咨询委员会（CAB）、风险
`"problem"`	问题管理、已知错误
`"cmdb"`	配置项搜索、关联关系、发现
`"user lookup"`	用户/组查询
`"query table"`	通用表查询

ServiceNow Development

ServiceNow开发

Query	Tools Found
`"widget"`	Widget create/update/sync
`"business rule"`	BR creation and management
`"script include"`	Reusable scripts
`"client script"`	Client-side scripts
`"ui policy"`	Form policies
`"ui action"`	Buttons and links
`"update set"`	Update Set lifecycle
`"snow deploy"`	Artifact deployment

查询语句	找到的工具
`"widget"`	组件创建/更新/同步
`"business rule"`	业务规则创建与管理
`"script include"`	可复用脚本
`"client script"`	客户端脚本
`"ui policy"`	表单规则
`"ui action"`	按钮与链接
`"update set"`	更新集生命周期管理
`"snow deploy"`	工件部署

ServiceNow Platform

ServiceNow平台

Query	Tools Found
`"flow designer"`	Flow/subflow creation
`"workspace"`	Workspace builder
`"catalog"`	Service catalog items
`"knowledge"`	Knowledge articles
`"notification"`	Email notifications
`"scheduled job"`	Scheduled scripts
`"rest"`	REST API integration
`"import"`	Import sets, transform maps

查询语句	找到的工具
`"flow designer"`	流程/子流程创建
`"workspace"`	工作区构建器
`"catalog"`	服务目录项
`"knowledge"`	知识库文章
`"notification"`	邮件通知
`"scheduled job"`	定时脚本
`"rest"`	REST API集成
`"import"`	导入集、转换映射

Activity & Instance

活动与实例

Query	Tools Found
`"activity"`	Activity tracking (always available)
`"instance info"`	Instance URL and config
`"property"`	System properties
`"logs"`	System logs

查询语句	找到的工具
`"activity"`	活动跟踪（始终可用）
`"instance info"`	实例URL与配置
`"property"`	系统属性
`"logs"`	系统日志

Enterprise (if enabled)

企业级工具（若已启用）

Query	Tools Found
`"jira"`	Jira issues, transitions, comments
`"azure devops"`	Work items, boards, pipelines
`"confluence"`	Pages, spaces, search
`"github"`	Issues, PRs, workflows, releases
`"gitlab"`	Issues, MRs, pipelines

查询语句	找到的工具
`"jira"`	Jira问题、状态转换、评论
`"azure devops"`	工作项、看板、流水线
`"confluence"`	页面、空间、搜索
`"github"`	问题、拉取请求、工作流、发布
`"gitlab"`	问题、合并请求、流水线

Always-Available Tools

始终可用的工具

These tools are loaded by default (no discovery needed):

javascript

// Activity tracking
activity_start({ source, storyTitle, storyType, ... })
activity_update({ activityId, status, summary })
activity_complete({ activityId, summary })
activity_add_artifact({ activityId, artifactType, ... })

// Core tool discovery
tool_search({ query, enable: true })

这些工具默认加载（无需发现）：

javascript

// 活动跟踪
activity_start({ source, storyTitle, storyType, ... })
activity_update({ activityId, status, summary })
activity_complete({ activityId, summary })
activity_add_artifact({ activityId, artifactType, ... })

// 核心工具发现
tool_search({ query, enable: true })

How tool_search Works

tool_search的工作原理

Search - Finds tools matching your query
Enable - Automatically enables found tools for your session
Use - Call the discovered tool by name

javascript

// Step 1: Search
tool_search({ query: "jira" })
// Returns: jira_search_issues, jira_get_issue, jira_create_issue, ...

// Step 2: Call discovered tool
jira_search_issues({ jql: "project = PROJ AND status = Open" })

搜索 - 找到与查询匹配的工具
启用 - 自动为当前会话启用找到的工具
使用 - 通过名称调用已发现的工具

javascript

// 步骤1：搜索
tool_search({ query: "jira" })
// 返回：jira_search_issues, jira_get_issue, jira_create_issue, ...

// 步骤2：调用已发现的工具
jira_search_issues({ jql: "project = PROJ AND status = Open" })

Search Tips

搜索技巧

Be Specific

具体化查询

javascript

// Too broad - may not find what you need
tool_search({ query: "github" })  // Returns 20+ tools

// More specific - finds exactly what you need
tool_search({ query: "github content" })      // File content tools
tool_search({ query: "github repository" })   // Repo info tools
tool_search({ query: "github pull request" }) // PR tools

javascript

// 过于宽泛 - 可能无法找到所需内容
tool_search({ query: "github" })  // 返回20+种工具

// 更具体 - 精准找到所需内容
tool_search({ query: "github content" })      // 文件内容工具
tool_search({ query: "github repository" })   // 仓库信息工具
tool_search({ query: "github pull request" }) // 拉取请求工具

Search by Action

按操作搜索

javascript

tool_search({ query: "create incident" })
tool_search({ query: "update widget" })
tool_search({ query: "query cmdb" })
tool_search({ query: "deploy business rule" })

javascript

tool_search({ query: "create incident" })
tool_search({ query: "update widget" })
tool_search({ query: "query cmdb" })
tool_search({ query: "deploy business rule" })

Search by Table

按表搜索

javascript

tool_search({ query: "sys_script_include" })
tool_search({ query: "sp_widget" })
tool_search({ query: "sysevent_email_action" })

javascript

tool_search({ query: "sys_script_include" })
tool_search({ query: "sp_widget" })
tool_search({ query: "sysevent_email_action" })

Tool Naming Patterns

工具命名规范

Tools follow consistent naming patterns:

Pattern	Example	Purpose
`snow_*`	`snow_query_table`	ServiceNow operations
`snow_deploy_*`	`snow_deploy_widget`	Artifact creation
`snow_update_*`	`snow_update_set_manage`	Update operations
`jira_*`	`jira_search_issues`	Jira integration
`azdo_*`	`azdo_search_work_items`	Azure DevOps
`confluence_*`	`confluence_create_page`	Confluence
`github_*`	`github_create_issue`	GitHub
`gitlab_*`	`gitlab_create_mr`	GitLab

工具遵循一致的命名模式：

模式	示例	用途
`snow_*`	`snow_query_table`	ServiceNow操作
`snow_deploy_*`	`snow_deploy_widget`	工件创建
`snow_update_*`	`snow_update_set_manage`	更新操作
`jira_*`	`jira_search_issues`	Jira集成
`azdo_*`	`azdo_search_work_items`	Azure DevOps集成
`confluence_*`	`confluence_create_page`	Confluence集成
`github_*`	`github_create_issue`	GitHub集成
`gitlab_*`	`gitlab_create_mr`	GitLab集成

MCP Server Categories

MCP服务器分类

Snow-Flow includes specialized MCP servers:

Server	Purpose	Example Tools
ServiceNow Unified	Core ServiceNow ops	Query, CRUD, scripts
ServiceNow Development	Artifact management	Deploy, widget sync
ServiceNow Automation	Script execution	Background scripts
ServiceNow ITSM	IT Service Management	Incidents, changes
ServiceNow Platform	Platform features	Flows, workspaces
Enterprise	External integrations	Jira, Azure, GitHub

Snow-Flow包含专用的MCP服务器：

服务器	用途	示例工具
ServiceNow Unified	ServiceNow核心操作	查询、CRUD、脚本
ServiceNow Development	工件管理	部署、组件同步
ServiceNow Automation	脚本执行	后台脚本
ServiceNow ITSM	IT服务管理	事件、变更
ServiceNow Platform	平台功能	流程、工作区
Enterprise	外部集成	Jira、Azure、GitHub

Best Practices

最佳实践

Discover Before Using - Always use
```
tool_search
```
first
Be Specific - Narrow queries find better matches
Check Results - Review tool descriptions before calling
Enable by Default -
```
enable: true
```
is the default
Silent Discovery - Don't tell users you're discovering tools

使用前先发现 - 始终先使用
```
tool_search
```
具体化查询 - 缩小查询范围以获得更匹配的结果
检查结果 - 调用前查看工具描述
默认启用 -
```
enable: true
```
为默认设置
静默发现 - 不要告知用户正在发现工具

Troubleshooting

故障排除

Issue	Solution
Tool not found	Try different query terms
Too many results	Be more specific in query
Tool doesn't work	Check parameters, may need auth
Enterprise tool missing	Verify enterprise auth status

问题	解决方案
未找到工具	尝试不同的查询关键词
结果过多	让查询更具体
工具无法工作	检查参数，可能需要认证
企业级工具缺失	验证企业认证状态

Example Workflows

示例工作流

Finding Incident Tools

查找事件工具

javascript

// Discover
tool_search({ query: "incident" })

// Use discovered tools
snow_query_incidents({ filters: { active: true, priority: 1 } })
snow_create_incident({ short_description: "...", caller_id: "..." })

javascript

// 发现工具
tool_search({ query: "incident" })

// 使用已发现的工具
snow_query_incidents({ filters: { active: true, priority: 1 } })
snow_create_incident({ short_description: "...", caller_id: "..." })

Finding Widget Tools

查找组件工具

javascript

// Discover
tool_search({ query: "widget" })

// Use discovered tools
snow_find_artifact({ type: "widget", query: "incident" })
snow_widget_pull({ widget_name: "incident-dashboard", local_path: "./widgets" })

javascript

// 发现工具
tool_search({ query: "widget" })

// 使用已发现的工具
snow_find_artifact({ type: "widget", query: "incident" })
snow_widget_pull({ widget_name: "incident-dashboard", local_path: "./widgets" })

Finding Enterprise Tools

查找企业级工具

javascript

// Discover Jira tools
tool_search({ query: "jira" })

// Use discovered tools
jira_search_issues({ jql: "project = SNOW AND status = Open" })
jira_transition_issue({ issueKey: "SNOW-123", transition: "In Progress" })

javascript

// 发现Jira工具
tool_search({ query: "jira" })

// 使用已发现的工具
jira_search_issues({ jql: "project = SNOW AND status = Open" })
jira_transition_issue({ issueKey: "SNOW-123", transition: "In Progress" })