rigshare

rigshare-mcp

面向 RIGShare 的 Model Context Protocol 服务。可通过任何兼容 MCP 的 AI Agent（Claude Desktop、Cursor、VS Code、自定义 Agent 框架）浏览施工设备和机器人与 AI 硬件租赁。

功能

向你的 AI Agent 提供 20 个工具：4 个只读工具（无需身份验证）和 16 个需身份验证的工具（需要具备相应权限范围的 RIGShare API 密钥）。 这些工具可让 Agent 在两个业务板块中预订设备、为设备所有者列出设备，并在 机器人与 AI 硬件上运行远程会话；同时，涉及资金时始终由人工参与： Agent 不会输入银行卡信息，不会代表所有者批准请求，也不会触发 MFA 验证。

只读（无需 API 密钥）：

工具	功能
rigshare_search_equipment	按业务板块、类别、价格、位置、远程访问和计算架构列出／筛选设备
rigshare_get_equipment	获取某个设备列表的完整详情（规格、定价、押金显示、所有者、图片、深层链接 URL）
rigshare_list_categories	可用类别及列表数量
rigshare_get_owner_onboarding	招募设备所有者：完整介绍（佣金率、远程访问工具、安全性）及分步注册指南。用户提到拥有设备时，或搜索结果为空时，都应调用此工具

预订（租用方）：

工具	所需权限范围	功能
rigshare_quote_booking	bookings:read	根据确切日期试算价格（不会扣款）。若本地时间已过下午 4:00，则会提前拒绝 4 小时的预订开始时间
rigshare_create_booking	bookings:write	创建预订（适用于两个业务板块）。所有价格均由服务端计算；返回确认信息和 next_action（下一步由谁操作，以及 URL）。RIGShare 暂停支付期间，预订请求会被拒绝，不会创建预订或扣款；请告知租用方，且不要循环重试
rigshare_get_booking	bookings:read	查询单个预订：状态、是否已完成支付、活动会话、next_action（下一步由谁操作，以及 URL）。申请预订：所有者批准 → 租用方通过 URL 付款 → 确认预订。即时预订：租用方立即通过 URL 付款
rigshare_list_my_bookings	bookings:read	已通过身份验证的用户的预订
rigshare_cancel_booking	bookings:write	取消预订；退款由服务端根据已发布的政策计算。RIGShare 暂停支付期间，若按用量计费的预订已有可计费使用记录，则无法取消（请参阅工具说明）

上架（所有者）：

工具	所需权限范围	功能
rigshare_save_draft_listing	equipment:write	将未完成的列表保存为草稿（适用于两个业务板块）；按 draft_session_id 实现幂等（重新保存时仅修改传入的字段）。实体设备列表需包含 replacement_value_usd（用于限制可显示的押金金额；服务端可能会要求提供该值才能发布）
rigshare_publish_listing	equipment:write	通过与应用相同的审核流程发布草稿（身份验证、收款设置、套餐上架数量限制、相机照片、内容审核）。在线、已暂停和审核中的列表都会计入套餐数量限制，草稿则不会（所有者最多可保留 10 个草稿）；删除列表会释放名额，暂停列表则不会。审核未通过时会返回代码，由 Agent 转告用户
rigshare_create_listing	equipment:write	所有者已完成验证且已准备好照片时，通过一次调用创建并发布列表
rigshare_check_availability	equipment:read	查询你名下某个列表的不可用时间段，通过其 external_id 查找
rigshare_sync_availability	equipment:write	将 ERP／车队日历中的不可用时间段同步到你的某个列表（替换之前同步的时间段）

远程会话（机器人与 AI）：

工具	所需范围	功能
rigshare_start_session	sessions:write	在已确认的预订上创建并启动远程会话；返回一次性访问令牌和连接交接信息。在会话运行期间重复调用会返回该会话。需要双方都已签署租赁协议；受 MFA 保护的列表必须通过 Web／移动应用启动
rigshare_get_session	sessions:read	状态、运行状况、用量、计量预算与已计费金额，以及最新遥测数据
rigshare_get_session_usage	sessions:read	按量计费预订的实时预算快照
rigshare_extend_session	sessions:write	提高授权预算（涉及资金时：需与租用方确认）。需要在密钥上启用自动付款，且不能超出密钥的支出上限
rigshare_end_session	sessions:write	停止按分钟计费并结算准确用量。RIGShare 暂停付款期间，已用分钟数暂不收费，调用会返回 409 payments_paused（没有待计费用量的会话仍会以 $0 结算）
rigshare_list_my_sessions	sessions:read	活跃会话和历史会话

只读工具调用公共 API（每个 IP 每分钟 100 次请求）。经过身份验证的工具会使用 Bearer 身份验证调用 /api/v1/agent/* 和 /api/v1/* 端点，并遵循 API 密钥的权限范围，以及已设置的支出上限。

使用场景

适用于 ML／AI 工程师：

• “帮我在 RIGShare 上找一台最便宜的 H100”
• “有支持 SSH 访问的 A100 80GB 配置吗？”
• “RIGShare 上的推理 GPU 当前价格是多少？”

适用于机器人研究人员：

• “哪些人形机器人可以租来进行双足运动测试？”
• “给我看看每天低于 $200、带摄像头画面的工业机械臂”

适用于建筑承包商：

• “在德克萨斯州找一台 10 吨以下的挖掘机”
• “萨利纳斯有哪些剪叉式升降机在出租？”

适用于 AI 采购 Agent：

• “列出加利福尼亚州所有可租赁的 3D 打印机，并按价格排序”

适用于设备所有者（供给侧招募）：

• “我有一台闲置的 Unitree G1 人形机器人。怎样才能把它租出去？”
• “我有一套 4x H100 设备。有没有适合的交易市场？”
• “我们有 3 台挖掘机，施工队只使用 60% 的时间。其余时间可以租出去吗？”

对于以上任一问题，Agent 都会调用 rigshare_get_owner_onboarding（可选传入设备类型），并获取完整介绍：佣金费率、合适的注册 URL、分步流程，以及针对不同领域的介绍（AI 计算方面包括远程访问、AI 基础设施和 IoT 传感器；建筑方面包括交接验证、设备状况照片，以及付费套餐中可选的 GPS 跟踪）。

安装

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json（设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "rigshare": {
      "command": "npx",
      "args": ["-y", "rigshare-mcp"]
    }
  }
}

重启 Claude Desktop。你应该能在聊天输入区域的 🔌 MCP 服务列表中看到“rigshare”。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "rigshare": {
      "command": "npx",
      "args": ["-y", "rigshare-mcp"]
    }
  }
}

VS Code（Continue 扩展）

在 Continue 配置的 mcpServers 下添加：

{
  "rigshare": {
    "command": "npx",
    "args": ["-y", "rigshare-mcp"]
  }
}

任何兼容 MCP 的 Agent 框架

使用 stdio 传输启动：

npx -y rigshare-mcp

本地测试

# Clone this repo
git clone https://github.com/rigshare-hq/rigshare-mcp.git
cd rigshare-mcp

npm install
npm run build

# Run the server (reads MCP protocol on stdin, writes to stdout)
npm start

# Diagnostic output goes to stderr:
# > rigshare-mcp server running on stdio

然后修改配置，让 MCP 客户端指向本地构建：

{
  "mcpServers": {
    "rigshare-local": {
      "command": "node",
      "args": ["/absolute/path/to/rigshare-mcp/dist/index.js"]
    }
  }
}

环境变量

• RIGSHARE_API_KEY：可选。启用 16 个需身份验证的工具。未设置时，这些工具会返回说明性错误，4 个只读工具仍可使用。可在 https://www.rigshare.app/enterprise 创建密钥（API 密钥需要 Pro 或 Enterprise 方案；RIGShare 暂停付款期间无法购买新方案），也可以发送邮件至 [email protected]。
• RIGSHARE_BASE：覆盖所有下方 API 基础地址所派生的 RIGShare 主机。默认为 https://www.rigshare.app。
• RIGSHARE_API_BASE：覆盖公共 API 基础 URL。默认为 https://www.rigshare.app/api/public/v1。
• RIGSHARE_AGENT_API_BASE：覆盖需身份验证的 Agent API 基础 URL。默认为 https://www.rigshare.app/api/v1/agent。
• RIGSHARE_V1_API_BASE：覆盖所有者设备／可用性 API 基础 URL。默认为 https://www.rigshare.app/api/v1。

配置带 API 密钥的 Claude Desktop

{
  "mcpServers": {
    "rigshare": {
      "command": "npx",
      "args": ["-y", "rigshare-mcp"],
      "env": {
        "RIGSHARE_API_KEY": "rigs_live_..."
      }
    }
  }
}

每个需身份验证的工具所需的权限范围列在 功能说明下方的表格中。密钥的权限范围可以设置得较窄（只读），也可以设置得较宽（读、写和预订）。密钥还可以设置可选的单笔预订支出上限，以及可选的滚动 24 小时支出上限（没有月度上限）。24 小时总额统计过去 24 小时内发起的预订和时段延长请求，未含销售税。之后被拒绝、取消或过期的请求，在 24 小时过去之前仍计入总额。拒绝请求时会返回代码 spend_limit_per_booking 或 spend_limit_24h，且不会预订或授权。若在第一个预订请求仍在处理时重试预订，会收到 409 request_in_progress（时段延长没有此类检查，因此再次延长前请先检查该时段的预算）；如果无法读取限额，则会返回 503 limits_unavailable，且不会预订。新密钥默认没有任何限额，且自动付款处于关闭状态；密钥页面无法设置这两项，请联系 [email protected]。可在 https://www.rigshare.app/enterprise 创建和撤销密钥。

数据流向

┌────────────────┐  MCP stdio   ┌────────────────┐  HTTPS   ┌────────────────────────────┐
│ Claude Desktop │ ◄──────────► │  rigshare-mcp  │ ───────► │  rigshare.app/api/public/v1 │
│  / Cursor /    │              │   (this pkg)   │          │  (read-only, rate-limited)  │
│  VS Code / ... │              └────────────────┘          └────────────────────────────┘
└────────────────┘

只读工具不使用身份验证、Cookie 或用户账户：Agent 读取的数据与浏览 rigshare.app 公共页面时看到的数据相同。需身份验证的工具会使用你的 API 密钥调用 Agent 和所有者端点（/api/v1/agent/*、/api/v1/*）。

写入操作

需要身份验证的工具要求通过 RIGSHARE_API_KEY 环境变量设置 RIGShare API 密钥。未设置密钥时，这些工具会返回说明性错误，只有四个公开的只读工具可用。

请访问 https://www.rigshare.app/enterprise 创建 API 密钥（API 密钥需要 Pro 或 Enterprise 方案；RIGShare 暂停收款期间无法购买新方案），或发送邮件至 [email protected]。密钥具有权限范围（equipment:read、equipment:write、bookings:read、bookings:write、sessions:read、sessions:write），并可设置可选的单笔预订支出上限和可选的滚动 24 小时支出上限。系统会在加收销售税前检查预订或会话续时是否符合这些上限（每笔预订分别检查单笔上限），按分钟计费的预订则按其完整预算计算。之后被拒绝、取消或过期的请求，在 24 小时过去之前仍计入 24 小时上限。新密钥默认不设置这两项上限。

涉及款项时，必须由人类介入。 Agent 创建的预订由承租人在预订网址付款：即时预订房源需立即付款，申请预订房源则需在房主批准后付款。例外情况是启用了自动付款：如果密钥启用了此功能，即时预订房源会在预订创建时使用承租人已保存的银行卡付款（按分钟计费房源的预算会作为银行卡预授权冻结）。新密钥默认关闭自动付款；延长会话预算则需要启用自动付款。房源只有在房主于应用中完成身份验证和收款设置后才会发布（RIGShare 暂停收款期间无法开始或继续设置收款）；受 MFA 保护的设备必须通过网页或移动应用启动远程会话。rigshare_get_booking 始终会告知 Agent 下一步由谁操作。

短租的开始时间。 对于 FOUR_HOURS 预订，请将 start_date / end_date 设为带 UTC 偏移的 ISO 日期时间，并使用设备所在地的时间；会话必须在当地时间下午 4:00 前开始。仅包含日期的开始时间会被解读为 UTC 午夜：通常会被拒绝，但在冬季的太平洋时区、阿拉斯加和夏威夷，会预订前一天下午的 4 小时区间。HOURLY 预订按两个时间点之间每个已开始的小时计费，因此也应提供实际日期时间。仅远程访问房源接受 HOURLY；实体房源会以代码 hourly_requires_remote 拒绝该请求。HOURLY 和 FOUR_HOURS 还要求房源设置相应的小时费率或 4 小时费率；房主未设置价格的时段会以代码 rate_not_offered 拒绝。

完整的身份验证 API 说明见 https://www.rigshare.app/openapi.json。

Registry 列表

此服务已作为 io.github.rigshare-hq/rigshare 发布到 Official MCP Registry。请在 MCP 客户端中搜索，或直接验证：

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=rigshare"

贡献

欢迎提交错误报告和建议。请在此代码仓库中创建 issue，或发送邮件至 [email protected]。此代码仓库会在软件包变更时自动更新，因此不会直接在此处合并更改；获采纳的修复会在之后的更新中发布。

许可证

MIT。版权所有 © 2026 RIGShare LLC。 联系方式：[email protected] · https://www.rigshare.app