Agent Skills › rcarmo/piclaw › mcp-adapter

mcp-adapter

GitHub

通过 pi-mcp-adapter 连接 MCP 服务器，提供统一的 mcp 工具及 /mcp 命令，支持本地与全局配置管理、工具搜索调用及状态交互。

skel/.pi/skills/mcp-adapter/SKILL.md rcarmo/piclaw

Trigger Scenarios

需要连接或管理 MCP 服务器使用 mcp 工具调用外部服务查看或搜索 MCP 工具列表

Install

npx skills add rcarmo/piclaw --skill mcp-adapter -g -y

More Options

Non-standard path

npx skills add https://github.com/rcarmo/piclaw/tree/main/skel/.pi/skills/mcp-adapter -g -y

Use without installing

npx skills use rcarmo/piclaw@mcp-adapter

指定 Agent (Claude Code)

npx skills add rcarmo/piclaw --skill mcp-adapter -a claude-code -g -y

安装 repo 全部 skill

npx skills add rcarmo/piclaw --all -g -y

预览 repo 内 skill

npx skills add rcarmo/piclaw --list

SKILL.md

Frontmatter

{
    "name": "mcp-adapter",
    "description": "Use the bundled pi-mcp-adapter to connect MCP servers through .pi\/mcp.json.",
    "distribution": "public"
}

MCP Adapter

Use pi-mcp-adapter to expose MCP servers to the agent through one mcp tool plus /mcp commands.

Config locations

Preferred project-local config:

/workspace/.pi/mcp.json

Starter example:

cp /workspace/.pi/mcp.json.example /workspace/.pi/mcp.json

The adapter also understands the global Pi config at:

/config/.pi/agent/mcp.json

Use the project-local file when you want MCP servers tied to the current workspace.

Minimal example

{
  "mcpServers": {
    "filesystem": {
      "command": "bunx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
      "lifecycle": "lazy"
    }
  }
}

Common workflows

List MCP status / tools

mcp({})

Search for a tool

mcp({ search: "read file" })

Describe a tool

mcp({ describe: "filesystem_read_file" })

Call a tool

mcp({ tool: "filesystem_read_file", args: "{\"path\":\"./README.md\"}" })

args must be a JSON string.

Interactive commands

/mcp
/mcp tools
/mcp reconnect
/mcp reconnect filesystem
/mcp-auth <server>

Notes

MCP servers are lazy by default and connect on first use.
After editing .pi/mcp.json, restart the session or reload Pi so the adapter re-reads config.
Prefer directTools only for small, high-value tool sets. Keep large MCP servers behind the mcp proxy.