Argosvix MCP server 让 AI 智能体（Claude Desktop、Cursor、Codex CLI、自定义 MCP 客户端）在对话中直接查询、管理和操作自身的 LLM 可观测性数据。它支持 stdio（子进程）和 HTTP（远程／自托管）两种传输方式。
【主要能力】 该服务端提供 89 个工具（86 个正式可用 + 3 个对客户账户返回 403 的内部运维工具）、3 个资源、8 个资源模板、3 个提示词。健康与异常端点包括 get_account_health、detect_anomaly、propose_alert_rules、classify_calls_batch、propose_eval_criteria；另有运行时控制面（预算闸门／策略闸门／人工审批闸门），使智能体既能观察也能采取行动。发布历史可在 npm 上查看。
使用前提是你已经通过 @argosvix/sdk 或 Python SDK 发送 LLM 调用。之后即可向 Claude / Cursor 提问，例如：
- “过去 24 小时我的 OpenAI 成本是多少？”
- “现在有哪些告警正在触发？”
- “显示今天最贵的 20 次调用。”
智能体通过该 MCP 服务器使用你的 Argosvix API 密钥获取数据，无需切换仪表盘标签页。
【安装与配置】 一键安装（先以无密钥方式启动；之后设置 ARGOSVIX_API_KEY 以使用自己账户的工具）。Claude Code 用户可安装 argosvix 插件，该插件捆绑了此服务器及安装技能。
Claude Desktop 配置：编辑配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %APPDATA%\Claude\claude_desktop_config.json），然后重启 Claude Desktop。全部 89 个工具会出现在 argosvix__ 前缀下（例如 argosvix__query_calls、argosvix__get_account_health、argosvix__create_budget_gate）。
Cursor 配置：编辑 ~/.cursor/mcp.json。
尚未获得 API 密钥时，服务器也可在没有 ARGOSVIX_API_KEY 的情况下以仅自省模式启动：全部 89 个工具都会列出以便评估接口面，且两个公共数据工具（get_synth_daily / get_daily_readthrough，即 Argosvix 自有的每日 AI 摘要与 OSS 解读）无需密钥即可使用。其他所有工具调用会返回获取密钥的说明，密钥地址为 https://dashboard.argosvix.com/api-keys 。关于公共数据工具的说明：它们仅属于默认的 full 配置档（不在 ARGOSVIX_MCP_PROFILE=core 中），并且与其他所有工具一样遵循 ARGOSVIX_API_BASE——若将服务器指向其他 base，它们会从该 base 无认证地请求 /v1/synth-daily 与 /v1/readthrough。
【工具配置档】 默认配置档为 full（全部 89 个工具）。若 MCP 客户端的上下文预算紧张，可设置 ARGOSVIX_MCP_PROFILE=core，仅暴露日常运维所需的 11 个核心工具：query_calls · aggregate_calls · get_cost_summary · get_percentiles · get_account_health · detect_anomaly · list_alerts · create_alert · silence_alert · unsilence_alert · get_deployed_prompt。该设置在 stdio 与 HTTP 传输下均有效，未知值会回退到 full 并在 stderr 给出警告。
【描述语言】 工具、资源与提示词的描述默认使用英文。设置 ARGOSVIX_MCP_LANG=ja 可获取原始的日文描述。未设置或未知值回退到 en（未知值会在 stderr 给出警告）。工具名称、输入模式与行为在两种语言下完全相同，仅面向人类／智能体的描述文本变化。该设置在 stdio 与 HTTP 传输下均有效。
【资源、资源模板与提示词】 资源暴露只读快照，智能体可将其拉入上下文而无需显式工具调用。资源模板让智能体根据已知 id 构造动态 URI；服务器在后端通过主键查询强制账户范围，跨账户 id 会返回 404。提示词是用户可作为斜杠命令启动的可复用模板。
【订阅功能（v0.10 起，仅 stdio）】 stdio 模式下声明 resources.subscribe 能力。客户端可订阅以下静态资源；服务器每 60 秒轮询每个已订阅资源，并在内容哈希变化时发出 notifications/resources/updated。可订阅 URI（资源模板如 argosvix://calls/{id} 不可订阅）：argosvix://account、argosvix://alerts/active、argosvix://cost/today。HTTP 传输（argosvix-mcp --http）不声明 subscribe 并拒绝订阅请求，因为其无状态的逐请求模式无法维持订阅集或投递服务器发起的通知；需要实时更新请使用 stdio。listChanged 有意不声明：资源列表在服务器生命周期内固定。
【实现说明（v0.10）】 单飞防护：缓慢的轮询周期不会启动并发的下一周期（不会出现重叠的 readResource 调用）。取消订阅／关闭竞态：在获取前与通知前按 URI 重新检查，外加 isShuttingDown 标志，避免对周期中途被移除的 URI 发出通知。失败处理：获取与通知失败均为静默（下一周期重试）；设置 ARGOSVIX_MCP_DEBUG=1 时服务器会将 { uri, errorClass } 记录到 stderr——有意不记录错误消息，以免泄露上游载荷文本。测试：150 个单元测试（含重叠单飞 + 取消订阅／关闭竞态 + 无效 URI → McpError(InvalidParams) + 轴 4 Tier 1 调度器覆盖）。
【数据与隐私】 MCP 服务器使用你的 API 密钥向 https://ingest.argosvix.com 发送查询。不暴露任何提示词或补全内容——仅暴露元数据（tokens、成本、延迟、模型名、你的标签）。项目采用 MIT 许可证，© Yuto Makihara (Argosvix)，详见 LICENSE。
【HTTP 远程与自托管】 服务器也可作为远程 MCP 端点通过 HTTP 运行，适合自托管或多租户场景（每次请求提供 API 密钥）。GET /health → 200 OK，返回服务器名称／版本（无需认证）；POST /mcp → MCP JSON-RPC 端点（需认证）。每个请求必须包含 Authorization: Bearer <api-key> 与有效的 Argosvix API 密钥（在 https://dashboard.argosvix.com/api-keys 签发）。服务器使用无状态模式（无会话 ID），因此每个请求相互独立，可携带不同密钥。默认绑定 127.0.0.1（仅本机）。使用 MCP_HTTP_HOST=0.0.0.0 可对外暴露，但生产环境需搭配反向代理 + TLS。针对本机绑定会应用 DNS 重绑定防护，通过将 Host 头与已知本机允许列表比对实现；非本机绑定时使用 MCP_HTTP_ALLOWED_HOSTS（逗号分隔）。请求体大小上限为 1 MiB。默认不记录后端错误响应体，以免生产日志聚合器包含后端内部载荷；如需在调试会话中启用原始响应体日志，可通过环境变量开启。未设置该环境变量时，错误日志仅包含 path、status 与 x-request-id。
