Luzia Crypto Prices

@luziadev/mcp-server

用于加密货币价格数据的模型上下文协议（MCP）服务。让 Claude 等 AI 助手能够通过 Luzia API 实时获取行情价格、交易所信息和 OHLCV 历史数据。

功能

• 获取多个交易所（Binance、Coinbase、Kraken、OKX、Bybit）的实时行情价格
• 获取用于技术分析的历史 OHLCV 蜡烛图数据
• 市场信息和交易对
• 交易所状态和可用性

要求

• Luzia API 密钥（在此获取）

远程连接（推荐）

使用 Luzia 和 AI 助手的最快方式是连接到我们托管的 MCP 服务：https://mcp.luzia.dev/mcp。无需安装，只需粘贴 URL 和 API 密钥。

Claude.ai 网页版 / Anthropic 控制台

设置 → 集成 → 添加自定义 MCP：

• URL： https://mcp.luzia.dev/mcp
• 身份验证： Bearer 令牌 — 粘贴你的 API 密钥（lz_...）

Claude Desktop（通过 mcp-remote）

Claude Desktop 的原生远程 MCP 支持仍在逐步推出，因此目前最简单的方法是使用 mcp-remote 适配器，它可以将远程 HTTP MCP 桥接到 Claude Desktop 的 stdio 接口。

编辑配置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.luzia.dev/mcp",
        "--header",
        "Authorization:Bearer lz_your_api_key"
      ]
    }
  }
}

重启 Claude Desktop（在 macOS 上按 Cmd+Q），然后开始提问。

VS Code、Cursor、Cline、Continue.dev

在工具的 MCP 设置中粘贴 URL 和 Authorization 标头：

• URL： https://mcp.luzia.dev/mcp
• 标头： Authorization: Bearer lz_your_api_key

MCP Inspector

npx @modelcontextprotocol/inspector

然后将 Inspector 指向 https://mcp.luzia.dev/mcp，并添加 Authorization: Bearer lz_... 标头。

本地安装（高级）

更喜欢在本地运行服务？@luziadev/mcp-server 仍在 npm 上发布，并通过 stdio 运行。

# Run directly with npx (no install needed)
LUZIA_API_KEY=lz_your_api_key npx -y @luziadev/mcp-server --stdio

Claude Desktop 配置（本地 stdio）

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

Claude Code 配置（本地 stdio）

添加到 .claude/settings.json：

{
  "mcpServers": {
    "luzia": {
      "command": "npx",
      "args": ["-y", "@luziadev/mcp-server", "--stdio"],
      "env": {
        "LUZIA_API_KEY": "lz_your_api_key"
      }
    }
  }
}

可用工具

工具	描述
get_ticker	获取指定交易对的当前价格
get_tickers	获取多个交易对或某个交易所所有交易对的价格
get_history	获取某个交易对的历史 OHLCV 蜡烛图数据
get_exchanges	列出支持的交易所（CEX 和 DEX）及其状态
get_markets	列出某个交易所的交易对，包括 DEX 流动性池元数据
get_tokens	列出规范资产和链上代币，并支持搜索和链筛选
get_token	按复合 ID（crypto:SYMBOL 或 {chain}:SYMBOL）查找单个代币
get_fiat_currencies	列出市场引用的 ISO 4217 法定货币

可用提示词

提示词是预构建的分析模板，可获取数据并生成结构化洞察。支持 MCP 提示词的客户端均可使用（例如通过 / 菜单使用 Claude Desktop）。

注意： Claude Code 不直接支持 MCP 提示词 — 请改用自然语言（例如，“分析 Binance 上 BTC/USDT 的价格走势”），它会自动调用底层工具。

提示词	描述
analyze_price_movement	分析交易对的价格变动和趋势
analyze_ohlcv	使用技术分析分析 OHLCV 蜡烛图数据
compare_exchanges	比较不同交易所的价格，寻找套利机会

提示词示例

analyze_price_movement

获取当前行情数据，并分析买卖价差、24 小时统计数据和交易量。

参数：

• exchange（必填）：例如 "binance"、"coinbase"
• symbol（必填）：例如 "BTC/USDT"、"ETH/USD"

Claude Desktop： 输入 / → 选择 analyze_price_movement → 填写 exchange: binance、symbol: BTC/USDT

自然语言（适用于任何客户端）：“分析 Binance 上 BTC/USDT 当前的价格走势”

analyze_ohlcv

获取历史 K 线数据，并请求技术分析，包括趋势、支撑位/阻力位、交易量模式和 K 线形态。

参数：

• exchange（必填）：例如 "binance"
• symbol（必填）：例如 "BTC/USDT"
• interval（可选）："1m"、"5m"、"15m"、"1h"、"1d"（默认值："1h"）
• period（可选）：例如 "24h"、"7d"、"30d"（默认值："24h"）

Claude Desktop： 输入 / → 选择 analyze_ohlcv → 填写 exchange: binance、symbol: BTC/USDT、interval: 1h

自然语言（适用于任何客户端）：“分析 Binance 上过去 7 天的 BTC/USDT OHLCV K 线，时间间隔为 1h”

compare_exchanges

从多个交易所获取行情数据，并比较价格、价差和流动性，以进行套利分析。

参数：

• symbol（必填）：例如 "BTC/USDT"
• exchanges（可选）：以逗号分隔的列表，例如 "binance,coinbase,kraken"（默认值："binance,coinbase,kraken"）

Claude Desktop： 输入 / → 选择 compare_exchanges → 填写 symbol: BTC/USDT

自然语言（适用于任何客户端）：“比较所有交易所的 BTC/USDT 价格”

速率限制

受你所订阅的 Luzia 套餐等级限制：

• 免费版： 每分钟 25 次请求，每天 1,000 次
• 专业版： 每分钟 1,000 次请求，每天 20,000 次

故障排除

“Unauthorized”错误

• 远程： 确认已设置 Authorization: Bearer lz_... 标头，且密钥以 lz_ 开头。
• Stdio： 确认在 MCP 客户端配置中设置了 LUZIA_API_KEY，且密钥未被撤销。

远程会话错误

• 如果客户端报告“Unknown session id”，说明服务已重启，或会话已过期（空闲 30 分钟）。重新连接后，客户端会自动重新初始化。

Claude Desktop 无法找到服务（stdio）

• 确认 claude_desktop_config.json 是有效的 JSON。
• 确认已安装 Node.js 20+（node --version）。
• 完全退出并重启 Claude Desktop（在 macOS 上按 Cmd+Q）。

许可证

MIT - 详情请参阅 LICENSE。