Claude Skill

mcp-tools

Imported from mrpulor-gh/nuphus/plugin/skills/builtin/mcp-tools.

LLM Mart · 0 points · 11 views 41 listing impressions 0 install-command copies

#mcp

Download mrpulor-gh-nuphus-plugin_skills_builtin_mcp-tools-6c8ce68.zip · 2 KB

Install

skills CLI npx skills add https://github.com/mrpulor-gh/nuphus/tree/main/plugin/skills/builtin/mcp-tools
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install mrpulor-gh-nuphus@llmmart
Git 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 中的 key
  • tool: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.

No comments yet.

Reviews (0)

No reviews yet.