Pi Auto

MCP运维云端

提供方 netandreus

运维云端 未标注 会话登录 社区 / 第三方 ClaudeCursor

pi-auto是一个提供自动负载均衡和高可用性策略的MCP服务器,用于管理Pi编码代理的后端服务使用情况。

一句话选型结论

按资料字段整理

Pi Auto 属于运维云端类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 8 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量8暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

负载均衡TypeScript本地部署高可用性后端管理自动化工具

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 8 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 8 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Pi Auto当前 8 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方netandreus上游标注的维护方 netandreus
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.1 KB
来自项目仓库与上游目录的原文,未做删改

pi汽车

pi汽车 是一个 Pi包 它提供了pi auto MCP服务器和技能 pi编码剂:使用数据来自 @球菌/pi 以及通过策略切换活跃提供商的工具-- 负载平衡 (均衡后端的使用)或 高可用性 (固定优先级顺序)。


先决条件

在使用pi-auto之前,请安装以下内容(全局):

依赖关系 描述
Pi编码代理 Pi CLI和编码代理(需要 pi 和扩展)。
@球菌/pi Pi代理使用跟踪;由MCP服务器用于使用数据。
别名 ccusage 运行快捷方式 @ccusage/pi (见下面的bash)。
pi-mcp适配器 Pi的MCP适配器(运行MCP服务器所需)。
@netandreus/pi游标提供程序 Pi的游标提供程序(可选;用于CursorAI后端的使用/策略)。

示例:全局安装并设置 ccusage 别名```bash

1. Pi Coding Agent

npm install -g @mariozechner/pi-coding-agent

2. Usage tracking (for pi-auto)

npm install -g @ccusage/pi

3. Alias for ccusage (pick one: bash or zsh)

echo "alias ccusage='npx @ccusage/pi@latest'" >> ~/.bashrc

echo "alias ccusage='npx @ccusage/pi@latest'" >> ~/.zshrc

4. Pi MCP adapter (run after Pi is installed)

pi install npm:pi-mcp-adapter

5. Cursor provider for Pi (optional)

pi install npm:@netandreus/pi-cursor-provider


然后重新加载shell(例如。 `source ~/.bashrc` 或 `source ~/.zshrc`)所以 `ccusage` 可用。

______________________________________________________________________

## 安装(Pi)

**先决条件:** 在Pi中安装MCP适配器,使其可以运行MCP服务器:```bash
pi install npm:pi-mcp-adapter

安装pi auto软件包(技能自动加载):```bash
pi install npm:@netandreus/pi-auto


或者从git:```bash
pi install git:github.com/netandreus/pi-auto

MCP配置: 将MCP服务器添加到pi的配置中,以便代理可以调用工具。

~/.pi/agent/mcp.json (或您的pi MCP配置路径):

如果您是通过安装的 pi install npm:@netandreus/pi-auto,pi使用全局npm;指向已安装的软件包。使用二进制名称(在包的全局npm安装后):```json
{
"mcpServers": {
"pi-auto": {
"command": "pi-auto-mcp",
"lifecycle": "keep-alive",
"directTools": true
}
}
}


或者使用显式路径(替换 `GLOBAL_NPM_ROOT` 随着输出 `npm root -g`):```json
{
"mcpServers": {
"pi-auto": {
"command": "node",
"args": ["GLOBAL_NPM_ROOT/@netandreus/pi-auto/dist/index.js"],
"lifecycle": "keep-alive",
"directTools": true
}
}
}

外露工具: mcp_pi-auto_pi_get_usage, mcp_pi-auto_pi_suggest_provider, mcp_pi-auto_pi_set_provider, mcp_pi-auto_pi_get_provider, mcp_pi-auto_pi_get_strategy, mcp_pi-auto_pi_set_strategy, mcp_pi-auto_pi_get_priority, mcp_pi-auto_pi_set_priority.

技能: 安装软件包后,技能会自动加载。调用 /skill:pi-auto 或者询问使用情况、平衡成本或更换提供商。


游标代理中的MCP

从以下位置使用pi auto MCP服务器 光标代理 (不仅来自Pi),连接服务器,启用它,并允许它的工具。

1.将MCP服务器连接到代理

将pi auto MCP服务器添加到Cursor的MCP配置中(例如。 ~/.cursor/mcp.json):```json
{
"mcpServers": {
"pi-auto": {
"command": "pi-auto-mcp",
"lifecycle": "keep-alive",
"directTools": true
}
}
}


### 2.启用MCP服务器

服务器可能显示为“未加载(需要批准)”。启用并批准它:```bash
agent mcp list
# pi-auto: not loaded (needs approval)

agent mcp enable pi-auto
# ✓ Enabled and approved MCP server: pi-auto

检查工具是否可用:```bash
agent mcp list-tools pi-auto

Tools for pi-auto (8):

- pi_get_priority ()

- pi_get_provider (scope, projectPath)

- pi_get_strategy ()

- pi_get_usage (period)

- pi_set_priority (priority)

- pi_set_provider (provider, model, scope, projectPath)

- pi_set_strategy (strategy)

- pi_suggest_provider (period)


### 3.允许使用此MCP中的工具

确保允许游标代理调用pi auto MCP工具。在 `~/.cursor/cli-config.json`,下 `permissions.allow`,包括:```json
"permissions": {
"allow": [
"Shell(ls)",
"Mcp(pi-auto:*)"
],
"deny": []
}

特性

工具 说明
pi_get_用法 给定时间段(例如每天)内每个后端(Claude Code、OpenAI Codex、CursorAI)的当前使用量(令牌/成本)。
pi_suggest_提供者 推荐 provider 和 model 基于当前的战略和优先事项。
pi_set_provider 写圆周率 defaultProvider 和 defaultModel (全球或项目范围)。
pi_get_提供者 读取当前pi默认提供程序和模型。
pi_get策略 / pi_set_策略 获取或设置策略: load-balancing 或 high-availability.
pi_get_优先级 / pi_set_priority 获取或设置HA优先级顺序(例如。 ["codex", "claude-code", "cursorai"]).

配置

要求: 节点18+,以及(用于使用数据) @球菌/pi 可通过 npx.

环境

变量 描述
PI_AGENT_DIR 覆盖pi代理会话目录(调用时使用 @ccusage/pi;默认值: ~/.pi/agent/sessions).
CCUSAGE_MCP_SETTINGS_PATH 覆盖圆周率的路径 全球 设置文件(默认值: ~/.pi/agent/settings.json).

服务器配置

策略和优先级存储在 ~/.pi/agent/pi-auto.json.

例子:json { "strategy": "load-balancing", "priority": ["codex", "claude-code", "cursorai"], "defaultModels": { "claude-code": { "provider": "anthropic", "model": "claude-sonnet-4-20250514" }, "codex": { "provider": "openai", "model": "gpt-4o" }, "cursorai": { "provider": "cursor", "model": "auto" } } }

字段 描述
策略 "load-balancing" (默认)或 "high-availability".
优先级 HA后端ID的有序列表;首选第一种。有效ID: claude-code, codex, cursorai.
DefaultModels 每个后端的提供者/模型的可选覆盖(必须与您安装的pi提供者匹配)。

使用策略

  • 负载平衡 — pi_suggest_provider 使用以下命令选择后端 最低 当前使用情况(令牌总数)。使用 pi_get_usage 查看每个后端的总计;然后打电话 pi_suggest_provider 并且可选 pi_set_provider 切换。
  • 高可用性 — pi_suggest_provider 返回 第一 后端在 priority (及其默认模型)。使用 pi_set_priority 更改顺序(例如,首选Codex,然后是Claude,然后是CursorAI)。

当您需要平衡成本或确保首选提供商时,请使用pi auto工具:获取/设置策略和优先级,获取当前提供商,获取使用情况,建议提供商,并设置为 pi_set_provider.


后端映射

使用来源 @ccusage/pi (与 --json --breakdown)映射到三个后端:

后端 源
克劳德代码 anthropic / claude-* 模型
OpenAI 代码专家 openai / gpt-* 模型
CursorAI cursor (例如。 @netandreus/pi游标提供程序)

您可以在中覆盖映射和默认模型 ~/.pi/agent/pi-auto.json 如果您的设置不同。


发布(npm)

发布到 npmjs.com:

  1. 登录: npm login (使用有权访问的帐户 @netandreus 范围)。
  2. 凹凸版本 在 package.json (例如。 0.1.0 → 0.1.1).
  3. 构建和发布:\
    npm publish\
    (跑步 prepublishOnly → yarn build,然后出版;作用域包通过以下方式作为公共包发布 publishConfig.access.)

查看将包含哪些内容: npm pack --dry-run.


许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Pi Auto 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Pi Auto 怎么在 Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Pi Auto 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Pi Auto 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Pi Auto 支持哪些客户端?

资料标注支持 Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Pi Auto 能提供哪些能力?

资料显示约 8 个工具;能力标签包括 TypeScript、Claude、云端部署。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。