Agent Skills › rcarmo/piclaw › mcp-adapter

mcp-adapter

GitHub

通过 pi-mcp-adapter 将 MCP 服务器暴露给 Agent，支持本地或全局配置管理。提供统一工具调用及交互命令，实现 MCP 服务的连接、搜索、描述与执行，默认采用懒加载机制。

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

Trigger Scenarios

需要调用外部 MCP 服务提供的工具配置或管理 .pi/mcp.json 中的 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.