mcp-tools
Imported from mrpulor-gh/nuphus/plugin/skills/builtin/mcp-tools.
#mcp
Install
npx skills add https://github.com/mrpulor-gh/nuphus/tree/main/plugin/skills/builtin/mcp-tools
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install mrpulor-gh-nuphus@llmmart
git clone https://github.com/mrpulor-gh/nuphus.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole mrpulor-gh/nuphus collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
MCP 工具参考
通过
skill_read mcp-tools加载本文档。WorkAgent 设计工作流时按需查阅。
原理
Nuphus 通过 MCP (Model Context Protocol) 连接外部工具。每个 MCP server 暴露一组 tools,可在工作流中用 do.mcp 步骤调用(V2 格式,与内置工具同级别):
{ "id": "search", "name": "搜问题",
"do": { "mcp": { "server": "github", "tool": "search_issues",
"with": { "query": "repo:nuphus bug", "limit": 5 } } },
"capture": "issues" }
server:plugin/mcp/servers.yaml中的 keytool:MCP 工具名with:工具参数(支持{{var}}模板)capture:字符串,输出存入变量(V2 规范,无as_type对象格式)
工具发现
servers.yaml 配置了新 server 但不确定其工具签名时,运行时自省:
{ "id": "list", "name": "列工具",
"do": { "mcp": { "server": "github", "tool": "tools/list", "with": {} } },
"capture": "tools" }
{{tools}} 含完整工具名与 inputSchema。
已配置的 Server
以下列表来自实际合并后的配置(plugin/mcp/servers.yaml + 本机私有覆盖)。配置变更后需同步更新本文档。
两层配置(合并读取,同名时本机层覆盖通用层):
| 层 | 路径 | 用途 | 是否入库 |
|---|---|---|---|
| 通用层 | plugin/mcp/servers.yaml |
随仓基础配置,可随发布版携带 | 是 |
| 本机层 | <数据目录>/mcp/servers.local.yaml |
仅本机可用的 server(本机路径/私有端点/个人工具) | 否 |
<数据目录> 即 crate::utils::nuphus_data_dir():Windows 为 %APPDATA%\.nuphus,
macOS 为 ~/Library/Application Support/.nuphus,Linux 为 ~/.local/share/.nuphus。
本机私有配置格式(与通用层完全一致):
servers:
<server-key>:
command: "npx"
args: ["-y", "<package>", "mcp"]
timeout_ms: 120000
auto_start: false
当前本机已配置的 server 以运行时实际合并结果为准(list_mcp_servers 可查)。
常用 Server 速查
| Server | 环境变量 | 常用工具 |
|---|---|---|
GitHub @modelcontextprotocol/server-github |
GITHUB_PERSONAL_ACCESS_TOKEN |
search_repositories / search_issues / create_issue / get_file_contents |
Postgres @modelcontextprotocol/server-postgres |
DATABASE_URL |
query(执行 SQL) |
Slack @modelcontextprotocol/server-slack |
SLACK_BOT_TOKEN |
send_message / list_channels / get_channel_history |
Filesystem @modelcontextprotocol/server-filesystem |
参数 --directory <允许目录> |
read_file / write_file / list_directory / search_files |
设计原则
- MCP 优先于 GUI:目标软件有 MCP server 时优先走
do.mcp,更快更稳且不依赖布局解析 - MCP 优先于 system_shell:MCP 返回结构化 JSON,比 CLI 文本解析可靠
- 降级路径:MCP server 不可用时降级到 system_shell 调用对应 CLI
- MCP 调用超时/失败:用
on_error(retry / allow_codes)控制,勿用死循环重试
Files (nuphus)
-
skill.json 566 B
Loading… -
SKILL.md 3.1 KB
--- title: MCP 工具参考 id: mcp-tools type: skill tags: [mcp, 工具, 集成, server, 工作流] --- # MCP 工具参考 > 通过 `skill_read mcp-tools` 加载本文档。WorkAgent 设计工作流时按需查阅。 ## 原理 Nuphus 通过 MCP (Model Context Protocol) 连接外部工具。每个 MCP server 暴露一组 `tools`,可在工作流中用 `do.mcp` 步骤调用(V2 格式,与内置工具同级别): ```json { "id": "search", "name": "搜问题", "do": { "mcp": { "server": "github", "tool": "search_issues", "with": { "query": "repo:nuphus bug", "limit": 5 } } }, "capture": "issues" } ``` - `server`:`plugin/mcp/servers.yaml` 中的 key - `tool`:MCP 工具名 - `with`:工具参数(支持 `{{var}}` 模板) - `capture`:**字符串**,输出存入变量(V2 规范,无 `as_type` 对象格式) ## 工具发现 servers.yaml 配置了新 server 但不确定其工具签名时,运行时自省: ```json { "id": "list", "name": "列工具", "do": { "mcp": { "server": "github", "tool": "tools/list", "with": {} } }, "capture": "tools" } ``` `{{tools}}` 含完整工具名与 inputSchema。 ## 已配置的 Server 以下列表来自实际合并后的配置(`plugin/mcp/servers.yaml` + 本机私有覆盖)。配置变更后需同步更新本文档。 **两层配置(合并读取,同名时本机层覆盖通用层)**: | 层 | 路径 | 用途 | 是否入库 | |---|---|---|---| | 通用层 | `plugin/mcp/servers.yaml` | 随仓基础配置,可随发布版携带 | 是 | | 本机层 | `<数据目录>/mcp/servers.local.yaml` | 仅本机可用的 server(本机路径/私有端点/个人工具) | **否** | `<数据目录>` 即 `crate::utils::nuphus_data_dir()`:Windows 为 `%APPDATA%\.nuphus`, macOS 为 `~/Library/Application Support/.nuphus`,Linux 为 `~/.local/share/.nuphus`。 **本机私有配置格式**(与通用层完全一致): ```yaml servers: <server-key>: command: "npx" args: ["-y", "<package>", "mcp"] timeout_ms: 120000 auto_start: false ``` 当前本机已配置的 server 以运行时实际合并结果为准(`list_mcp_servers` 可查)。 ## 常用 Server 速查 | Server | 环境变量 | 常用工具 | |--------|---------|---------| | GitHub `@modelcontextprotocol/server-github` | `GITHUB_PERSONAL_ACCESS_TOKEN` | `search_repositories` / `search_issues` / `create_issue` / `get_file_contents` | | Postgres `@modelcontextprotocol/server-postgres` | `DATABASE_URL` | `query`(执行 SQL) | | Slack `@modelcontextprotocol/server-slack` | `SLACK_BOT_TOKEN` | `send_message` / `list_channels` / `get_channel_history` | | Filesystem `@modelcontextprotocol/server-filesystem` | 参数 `--directory <允许目录>` | `read_file` / `write_file` / `list_directory` / `search_files` | ## 设计原则 - **MCP 优先于 GUI**:目标软件有 MCP server 时优先走 `do.mcp`,更快更稳且不依赖布局解析 - **MCP 优先于 system_shell**:MCP 返回结构化 JSON,比 CLI 文本解析可靠 - **降级路径**:MCP server 不可用时降级到 system_shell 调用对应 CLI - **MCP 调用超时/失败**:用 `on_error`(retry / allow_codes)控制,勿用死循环重试
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.