Pi MCP Tools

@zhafron/pi-mcp工具

用于pi编码代理的通用MCP（模型上下文协议）工具扩展。

安装

pi install git:github.com/tickernelz/pi-mcp-tools

或者通过npm：

pi install npm:@zhafron/pi-mcp-tools

快速开始

增添 ~/.pi/agent/settings.json:

{
  "mcp": {
    "web-search": {
      "type": "local",
      "command": ["npx", "-y", "@zhafron/mcp-web-search"]
    },
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "your-api-key"]
    },
    "deepwiki": {
      "type": "remote",
      "url": "https://mcp.deepwiki.com/mcp"
    },
    "filesystem": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"],
      "enabled": true
    }
  }
}

配置格式

每个MCP服务器都是以下密钥 "mcp" 具有以下结构：

本地服务器

{
  "server-name": {
    "type": "local",
    "command": ["npx", "-y", "package-name", "args..."],
    "env": { "KEY": "value" },
    "cwd": "/path/to/workdir",
    "enabled": true,
    "toolPrefix": "prefix",
    "filterPatterns": ["pattern1", "pattern2"]
  }
}

远程服务器

{
  "server-name": {
    "type": "remote",
    "url": "https://example.com/mcp",
    "headers": { "Authorization": "Bearer token" },
    "enabled": true,
    "toolPrefix": "prefix"
  }
}

运输自动检测：

• Websocket： ws://, wss://，或URL包含“websocket”
• StreamableHTTP:MCP协议2025-xx（最新标准）
• SSE：遗留服务器或回退

命令

标志： --mcp-debug -启用调试日志记录

工具

工具自动注册为： mcp_{server}_{tool} 或 {toolPrefix}_{tool}

例子： mcp_web-search_search, ctx7_read_docs

例子

多个供应商

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "ctx7sk-..."]
    },
    "deepwiki": {
      "type": "remote",
      "url": "https://mcp.deepwiki.com/mcp"
    },
    "chrome-devtools": {
      "type": "local",
      "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
    },
    "web-search": {
      "type": "local",
      "command": ["npx", "-y", "@zhafron/mcp-web-search"]
    },
    "octocode": {
      "type": "local",
      "command": ["npx", "octocode-mcp@latest"]
    }
  }
}

使用环境变量

{
  "mcp": {
    "github": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_..." }
    },
    "postgres": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/db"]
    }
  }
}

暂时禁用服务器

{
  "mcp": {
    "web-search": {
      "type": "local",
      "command": ["npx", "-y", "@zhafron/mcp-web-search"],
      "enabled": true
    },
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp"],
      "enabled": false
    }
  }
}

禁用单个工具

工具可以通过以下方式禁用 /mcp-tools 命令（交互式UI）或在设置中手动：

{
  "mcp": { ... },
  "mcpDisabledTools": ["mcp_context7_query-docs", "mcp_web-search_fetch_url"]
}

禁用工具在全球范围内持续存在 ~/.pi/agent/settings.json.

发展

npm install
npm run build       # Type check
npm run format      # Format code
npm run format:check

发布

npm version patch  # Bump version
git push --tags    # Trigger npm publish

链接

• 报告问题

许可证

麻省理工学院