Lithium Vault

Name: Lithium Vault
Author: ciinkwia

本地服务

github.com/ciinkwia开发工具06 周前更新

代码仓库

关于 Lithium Vault

Lithium Vault 是供 Agent 和分析人员查询锂及电池金属一手数据的 MCP 服务，覆盖生产商和矿山。它提供带来源引用的产量、成本、储量、所有权、财务、比较分析及锂辉石历史价格，并由用户钱包按次支付 USDC。

主要功能

01来自监管文件的生产商和矿山数据
02产量、成本、储量及所有权信息
03带引用的比较和文字评估
04锂辉石历史价格序列
05按次 USDC 付款并设价格上限

适用场景

01查看生产商或矿山的运营数据
02比较成本位置和资产负债表韧性
03检查带引用的风险、优势和数据缺口
04查询历史锂辉石基准价格

MCP 相关

它向 MCP 客户端开放锂及电池金属数据工具。工具调用从配置的钱包按次支付 USDC，并受价格上限约束。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "lithium-vault": {
      "command": "npx",
      "args": [
        "-y",
        "lithium-vault-mcp"
      ],
      "env": {
        "CDP_API_KEY_ID": "<CDP_API_KEY_ID>",
        "CDP_API_KEY_SECRET": "<CDP_API_KEY_SECRET>",
        "CDP_WALLET_SECRET": "<CDP_WALLET_SECRET>",
        "CDP_ACCOUNT_NAME": "<CDP_ACCOUNT_NAME>",
        "VAULT_BASE_URL": "<VAULT_BASE_URL>",
        "X402_MAX_PRICE": "<X402_MAX_PRICE>"
      }
    }
  }
}

启动命令npx -y lithium-vault-mcp

需要配置的环境变量

CDP_API_KEY_ID密钥Coinbase CDP API key ID for the wallet that pays the per-call USDC fee

CDP_API_KEY_SECRET密钥Coinbase CDP API key secret

CDP_WALLET_SECRET密钥Coinbase CDP wallet secret

CDP_ACCOUNT_NAMENamed CDP account to pay from (default: lithium-vault-mcp)

VAULT_BASE_URLOverride the vault endpoint base URL (default: https://clink-lithium-vault.fly.dev)

X402_MAX_PRICEMax USD price per call the server will pay before refusing (default: 0.25)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmlithium-vault-mcp0.4.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

lithium-vault-mcp

一个 MCP 服务，为你的 AI Agent 提供锂矿／电池金属矿业的一手数据——涵盖 40 家生产商和 49 座矿山的产量、AISC、储量、所有权、特许权使用费、包销协议和公司财务数据；每项数据均摘自 SEC / ASX / TSX / SEDAR / cninfo 文件，并按汇率换算为美元。

数据来自 Lithium Research Vault（在 agentic.market 上架）。每次调用工具都通过 x402 使用 你自己的钱包以 USDC 按请求付费——无需订阅，我们这边也不需要 API 密钥。

工具

工具	价格	返回内容
`lithium_vault_summary`	$0.02	一行摘要：最新产量、按产量加权的 AISC、实际售价、现金／债务／EBITDA／FCF、储量、最大持有人和来源文件
`lithium_vault_raw`	$0.05	完整结构化数据行：各期产量、AISC、储量、所有权、特许权使用费、包销协议和财务数据
`lithium_vault_comparables`	$0.20	相对于整个跟踪范围的成本曲线百分位排名及最接近的同行、资源规模排名和资产负债表生存能力排名——每项数据均附有引用
`lithium_vault_verdict`	$0.05	附有引用的通俗解读：成本曲线位置、资产负债表生存能力、许可／开发阶段、风险、优势和数据缺口——仅陈述事实，不构成投资建议
`lithium_spodumene_history`	$0.05	历史 SC6 锂辉石精矿基准价格序列（按日／周／月），覆盖整个市场——无需指定实体

lithium_vault_summary、lithium_vault_raw、lithium_vault_comparables 和 lithium_vault_verdict 均接受 entity（例如 ALB、SQM、PILBF、ATUSF 等股票代码，或 Greenbushes、 Pilgangoora、Grota do Cirilo 等矿山名称）以及 level（company 或 mine）。如果 Vault 中没有该实体，将返回 400，且不收费。

lithium_spodumene_history 无需指定实体——它是覆盖整个市场的单一价格序列。可选输入：interval（daily | weekly | monthly，默认值为 daily）、from 和 to（YYYY-MM-DD）。三个参数都省略时，将返回完整的每日历史数据。

前提条件

准备一个已充值的 Coinbase CDP 钱包，其中含有 Base 上的 USDC。请自备钱包；服务会从中支付每次调用的费用（CDP 负责支付 Gas）。请在 portal.cdp.coinbase.com 获取 CDP API 凭据。

安装与配置

Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "lithium-vault": {
      "command": "npx",
      "args": ["-y", "lithium-vault-mcp"],
      "env": {
        "CDP_API_KEY_ID": "your-cdp-api-key-id",
        "CDP_API_KEY_SECRET": "your-cdp-api-key-secret",
        "CDP_WALLET_SECRET": "your-cdp-wallet-secret",
        "X402_MAX_PRICE": "0.25"
      }
    }
  }
}

Claude Code

claude mcp add lithium-vault \
  --env CDP_API_KEY_ID=... \
  --env CDP_API_KEY_SECRET=... \
  --env CDP_WALLET_SECRET=... \
  --env X402_MAX_PRICE=0.25 \
  -- npx -y lithium-vault-mcp

配置

环境变量	默认值	用途
`CDP_API_KEY_ID` / `CDP_API_KEY_SECRET` / `CDP_WALLET_SECRET`	—	必填。你的 CDP 钱包，即用于支付的钱包。
`CDP_ACCOUNT_NAME`	`lithium-vault-mcp`	用于支付的命名 CDP 账户（自动创建）。
`X402_MAX_PRICE`	`0.25`	安全上限。服务会在付款前检查公布的价格，并拒绝任何高于此值的调用，避免因配置错误而多付。
`VAULT_BASE_URL`	`https://clink-lithium-vault.fly.dev`	仅用于测试时覆盖。

工作原理

your agent → MCP tool call → this server → [x402 402 → pay USDC from your wallet → retry] → vault → data

服务会先读取端点公布的价格，并在授权任何付款前执行 X402_MAX_PRICE 限制。你只会按固定的分级价格付费（$0.02 / $0.05 / $0.20——各工具对应的价格见上表）。默认的 X402_MAX_PRICE 为 0.25，已涵盖所有工具，包括价格为 $0.20 的 lithium_vault_comparables。