关键词

资产价格金融数据贵金属加密货币实时数据

使用说明

项目简介

Asset Price MCP Server (asset-price-mcp) 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 提供访问实时资产价格信息的能力。通过集成此服务器，LLM 可以查询包括贵金属、加密货币等多种资产的最新价格，从而增强 LLM 在金融信息处理和应用方面的能力。

主要功能点

  • 实时资产价格查询: 提供工具（Tool）'get_asset_price'，允许 LLM 获取多种资产的当前价格信息。
  • 支持多种资产类型: 涵盖贵金属（如黄金、白银）、加密货币等多种资产类别。
  • 数据缓存: 内置缓存机制，减少API请求频率，提高响应速度。
  • 标准MCP协议: 遵循 MCP 协议规范，易于与各种 MCP 客户端集成。
  • 易于部署和配置: 提供简单的安装和配置步骤，方便用户快速部署和使用。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
  2. 克隆仓库: 将 GitHub 仓库 'asset-price-mcp' 克隆到本地。 
    git clone https://github.com/mk965/asset-price-mcp
cd asset-price-mcp
  3. 安装依赖: 在仓库根目录下运行以下命令安装项目依赖。 
    npm install
  4. 构建项目: 运行以下命令构建项目。 
    npm run build

服务器配置

要将 Asset Price MCP Server 集成到 MCP 客户端，你需要配置客户端以连接到此服务器。以下是针对不同操作系统的 MCP 服务器配置示例，通常在 MCP 客户端的配置文件（如 JSON 格式）中进行配置。

Smithery 客户端自动安装配置 (Claude Desktop): 如果你使用 Claude Desktop 客户端，可以通过 Smithery 自动安装和配置 'asset-price-mcp' 服务器。运行以下命令：

npx -y @smithery/cli install @mk965/asset-price-mcp --client claude

手动配置示例 (MacOS/Linux):

{
  "mcpServers": {
    "Asset Price Server": {  // 服务器名称，可以自定义
      "command": "npx",      // 启动服务器的命令，这里使用 npx 运行 npm 包
      "args": ["-y", "assets-price-mcp"] // 命令参数，-y 表示自动确认，assets-price-mcp 是包名
    }
  }
}

手动配置示例 (Windows):

{
  "mcpServers": {
    "Asset Price Server": {  // 服务器名称，可以自定义
      "command": "cmd",      // Windows 下使用 cmd 命令行
      "args": ["/c", "npx", "-y", "assets-price-mcp"] // /c 表示执行命令后关闭 cmd 窗口
    }
  }
}

配置参数说明:

  • '"Asset Price Server"': MCP 服务器的名称，在客户端中用于标识和引用此服务器。你可以自定义名称。
  • '"command"': 启动 MCP 服务器的命令。这里 'npx assets-price-mcp' 会在本地查找并执行 'assets-price-mcp' 包（package.json 中配置的 'name' 字段）。由于该包已经配置在 'package.json' 中，并且在安装依赖后可以通过 'npx' 找到，因此可以直接使用包名运行。如果需要直接运行构建后的 'index.js' 文件，可以将 'command' 设置为 'node'，'args' 设置为 '["path/to/asset-price-mcp/build/index.js"]' （需要替换为实际路径）。
  • '"args"': 传递给启动命令的参数。'"-y"' 通常用于 npm 或 npx 命令，表示自动确认； '"assets-price-mcp"' 是要执行的 npm 包名。在 Windows 环境下，'/c' 参数用于让 'cmd' 执行完命令后关闭。

请注意: 以上配置假设你已经将 'asset-price-mcp' 项目构建后的文件放在了合适的位置，并且 MCP 客户端能够找到 'npx' 命令（通常 Node.js 安装后会自动配置 'npx' 到环境变量）。实际配置可能需要根据你的 MCP 客户端和环境进行调整。

基本使用方法

  1. 启动 MCP 服务器: 配置完成后，当 MCP 客户端尝试连接或使用 Asset Price Server 时，客户端会根据配置的 'command' 和 'args' 启动服务器。通常，服务器会在后台运行，并通过标准输入输出 (stdio) 与客户端通信。

  2. 使用 'get_asset_price' 工具: 在 LLM 应用或 MCP 客户端中，你可以调用 'get_asset_price' 工具来查询资产价格。该工具无需任何参数，调用后服务器会返回包含当前资产价格信息的文本内容。

    例如，在与 LLM 的对话中，你可以指示 LLM 调用此工具来获取信息，例如：

    请帮我查询当前贵金属和加密货币的价格信息。

    LLM 客户端（如果配置正确）将解析用户指令，并调用 'get_asset_price' 工具，然后将服务器返回的价格信息展示给用户。

预期输出

工具 'get_asset_price' 成功执行后，会返回包含资产价格信息的文本内容，例如：

Current Asset Prices:
Name: Gold
Price: 2,333.45
Symbol: XAU
Updated: 2024-07-20T10:30:00Z
---
Name: Bitcoin
Price: 65,000.00
Symbol: BTC
Updated: 2024-07-20T10:35:00Z
---
... (更多资产价格)

如果API请求失败或没有可用数据，服务器会返回相应的错误提示信息。

信息

分类

商业系统

访问项目