NexaLayer

NexaLayer MCP 服务

此目录包含 MCP 服务包及其实现。有关仓库概览、安装选项、完整的 16 个工具目录以及后端关系，请参阅根 README。

将 MCP 客户端连接到 NexaLayer 产品、会话、运行状况、用量和支出控制。

{
  "mcpServers": {
    "nexalayer": {
      "command": "npx",
      "args": ["-y", "@nexalayer/mcp"],
      "env": { "NEXALAYER_API_KEY": "agk_your_key" }
    }
  }
}

服务仅向 stdout 写入协议消息。API 错误通过 MCP 工具结果返回。工具注释会标记读取、付费写入、策略更改和破坏性清理，以便兼容的客户端应用审批策略。

工具

• 读取：产品及精确价格、会话详情、运行状况、用量、预算、提醒、余额和交易。
• 付费写入：创建或轮换会话。使用唯一的 idempotency_key 并获得所有者批准。
• 策略写入：更改 API-Key 和每日预算限额。需要所有者批准。
• 清理：任务结束时终止会话。提前终止不代表退款。如果上游服务不可用，计费会在首次尝试终止时停止，NexaLayer 会在后台重试释放。
• 支持（免费）：nexalayer_check_status、nexalayer_known_issues、nexalayer_report_issue 和 nexalayer_get_ticket。

nexalayer_list_products 会返回精简的游标分页目录。默认显示 20 个当前可用产品，支持 type、country、in_stock、limit 和 cursor，并排除内部定价和供应商字段。

nexalayer_create_session 会从账户余额中扣费。先读取当前报价和预算，再获得所有者批准后调用。POST /sessions 不会处理 include_credentials，并且会省略代理凭据。PRICE_MISMATCH（409）：重新读取价格，重试一次。BUDGET_EXCEEDED 和 INSUFFICIENT_BALANCE（402）：询问所有者，不要重试。

nexalayer_get_session 和 nexalayer_rotate_session 接受可选的 include_credentials（默认值为 false），并将其传递给 API。除非 include_credentials=true，否则不会返回凭据；切勿记录这些凭据。

购买前务必先读取 nexalayer_list_products，因为它会返回由 openAgent 支持的当前报价和可用情况。专属静态代理会话的价格为 $1.43–$5.86/月（上线价格，以实时 API 为准）。

nexalayer_list_products → nexalayer_get_budget → owner approval
→ nexalayer_create_session → nexalayer_get_session → health/usage → nexalayer_terminate_session

常见 API 错误代码包括 AUTH_INVALID_KEY、INSUFFICIENT_BALANCE、BUDGET_EXCEEDED、PRICE_MISMATCH、IDEMPOTENCY_CONFLICT 和 RATE_LIMIT_EXCEEDED。

PRICE_MISMATCH 的 HTTP 状态码为 409：重新读取价格，重试一次。BUDGET_EXCEEDED 和 INSUFFICIENT_BALANCE 的 HTTP 状态码为 402：询问所有者，不要重试。

错误与支持

API 调用失败时会返回 MCP 工具错误（isError: true），其中包含一行摘要，以及 structuredContent.error 中完整的 NexaLayer 错误对象：code、retryable、retry_after、suggested_action、side_effects、doc_url、known_issue_id 和 request_id。请根据这些字段分支处理，不要根据消息文本判断。

如果错误含义不明确：

follow error.suggested_action → nexalayer_check_status → nexalayer_known_issues(error_code)
→ nexalayer_report_issue → poll nexalayer_get_ticket after next_check_after_seconds

服务会保留最近 20 个收到的请求 ID 和错误代码，并将它们连同 MCP 客户端名称和包版本自动附加到 nexalayer_report_issue。切勿在工单中填写 API 密钥、代理密码或 full_url。响应目标为早期访问阶段的预期目标，并非保证：S1 为 4 小时，S2 为 24 小时，S3 为 3 个工作日，S4 为尽力而为。人工联系邮箱：[email protected]（Telegram @LEWISMIN）。

Docker

从仓库根目录构建 stdio MCP 服务：

docker build -t nexalayer-mcp ./mcp

容器无需凭据即可启动并展示其工具目录，方便 MCP 目录和客户端安全地检查：

docker run -i --rm nexalayer-mcp

仅在调用 NexaLayer 工具时于运行时传入 API Key：

docker run -i --rm \
  -e NEXALAYER_API_KEY="$NEXALAYER_API_KEY" \
  nexalayer-mcp

NEXALAYER_BASE_URL 仍为可选项。镜像使用 stdio，不会开放网络端口，也不包含凭据。

前往 https://nexalayer.net/agents?source=mcp-readme 申请 API 密钥和一次性试用额度。