Chainlink Feeds MCP Server

Chainlink Feeds MCP 服务

一个 MCP 服务，可实时访问 Chainlink 的去中心化链上价格馈送，针对与 AI Agent 和自主系统的无缝集成进行了优化

功能

• 查询最新价格：获取指定链（例如 ethereum）上特定价格馈送交易对（例如 FIL/ETH）的最新价格，包括价格、小数位数、轮次 ID 和时间戳。
• 按轮次 ID 查询价格：获取特定轮次 ID 的价格数据（由于链上历史数据有限，目前为占位功能）。
• 列出支持的链：获取以逗号分隔的支持区块链网络列表（例如 ethereum,base）。
• 列出所有馈送：获取 Markdown 格式的所有链及其价格馈送名称列表（例如 - ethereum: FIL/ETH,FDUSD/USD）。
• 按链列出馈送：获取特定链的逗号分隔价格馈送名称列表（例如 ethereum 的 FIL/ETH,FDUSD/USD）。
• 可配置馈送：在 feeds.json 文件中定义价格馈送和 RPC 端点，支持多个链和馈送类别。

支持的链和馈送

根据 feeds.json 的定义，服务支持 9 个区块链网络，共包含 329 个价格馈送：

• Ethereum：107 个馈送（例如 FIL/ETH、BTC/USD、USDC/USD）
• BNB Chain (bsc)：80 个馈送（例如 DOT/USD、CAKE/USD、BUSD/BNB）
• Base：52 个馈送（例如 AXL/USD、USDC/USD、WIF/USD）
• Starknet：9 个馈送（例如 ETH/USD、BTC/USD、WSTETH/ETH）
• Linea：15 个馈送（例如 ETH/USD、FOXY/USD、MATIC/USD）
• Mantle：6 个馈送（例如 MNT/USD、USDT/USD、BTC/USD）
• Scroll：22 个馈送（例如 SCR/USD、STETH/USD、WBTC/BTC）
• zkSync：16 个馈送（例如 ZK/USD、PEPE/USD、TRUMP/USD）
• Celo：22 个馈送（例如 CELO/USD、CUSD/USD、NGN/USD）

如需添加其他链和馈送，可在 feeds.json 中更新网络配置，并添加 Chainlink 价格馈送文档中的代理地址。

前提条件

• Node.js：18.x 或更高版本。
• npm：用于安装依赖项。
• Infura API 密钥：从 MetaMask Developer Dashboard 获取密钥，并确保其可访问受支持的网络（例如 Ethereum、Base）。
• MCP Inspector（可选）：用于在本地测试服务。
• Claude Desktop（可选）：用于集成 Anthropic 的 Claude 界面。

安装

1. 克隆代码库：

   git clone https://github.com/kukapay/chainlink-feeds-mcp.git
   cd chainlink-feeds-mcp
   

2. 安装依赖项：

   npm install
   

   项目需要：

   • @modelcontextprotocol/sdk：用于 MCP 服务功能。
   • ethers：6.x 版本，用于区块链交互。
   • zod：用于输入验证。
   • dotenv：用于管理环境变量。

3. 配置 MCP 客户端： 如需通过 Claude Desktop 等 MCP 客户端使用此服务，请将以下内容添加到配置文件（或等效文件）中：

   {
     "mcpServers": {
       "chainlink-feeds-mcp": {
         "command": "node",
         "args": ["path/to/chainlink-feeds-mcp/index.js"],
         "env": { "INFURA_API_KEY": "your_api_key_here" }
       }
     }
   }   
   

使用方法

该服务通过 MCP 协议提供五种工具，可通过 Claude Desktop（用于自然语言查询）或 MCP Inspector（用于 JSON 输入）访问。下面列出这些工具，并分别提供自然语言（通过 Claude Desktop）和 JSON 格式的示例。

工具：getLatestPrice

• 描述：获取指定链上某个交易对的最新价格，并返回如下 JSON 对象：

  {
    "chain": "ethereum",
    "pair": "FIL/ETH",
    "price": 0.01234,
    "decimals": 18,
    "roundId": "123456",
    "timestamp": "2025-04-17T12:00:00.000Z",
    "proxyAddress": "0x0606Be69451B1C9861Ac6b3626b99093b713E801",
    "feedCategory": "medium"
  }
  

• 参数：

  • pair（string）：价格数据对，例如 FIL/ETH。
  • chain（string）：区块链网络，例如 ethereum。

• 自然语言示例（Claude Desktop）：

  输入：“Ethereum 上 FIL/ETH 的最新价格是多少？”

  输出：“Ethereum 上 FIL/ETH 的最新价格为 0.01234，小数位数为 18，轮次 ID 为 123456，更新时间为 2025-04-17 12:00:00 UTC。”

工具：queryPriceByRound

• 描述：查询指定链上某个交易对和轮次 ID 对应的价格，并返回如下 JSON 对象：

  {
    "chain": "ethereum",
    "pair": "FDUSD/USD",
    "price": 1.0001,
    "decimals": 8,
    "roundId": "123",
    "timestamp": "2025-04-17T12:00:00.000Z",
    "proxyAddress": "0xfAA9147190c2C2cc5B8387B4f49016bDB3380572",
    "feedCategory": "medium"
  }
  

• 参数：

  • roundId（string）：价格数据的轮次 ID。
  • pair（string）：价格数据对，例如 FDUSD/USD。
  • chain（string）：区块链网络，例如 ethereum。

• 自然语言示例（Claude Desktop）：

  输入：“能帮我查询 Ethereum 上轮次 ID 为 123 的 FDUSD/USD 价格吗？”

  输出：“Ethereum 上轮次 ID 为 123 的 FDUSD/USD 价格为 1.0001，小数位数为 8，更新时间为 2025-04-17 12:00:00 UTC。注意：由于历史数据有限，此响应为占位内容。”

工具：listSupportedChains

• 描述：返回所有受支持区块链网络的逗号分隔列表。

• 参数：无。

• 自然语言示例（Claude Desktop）：

  输入：“此服务支持哪些区块链网络？”

  输出：“此服务支持以下网络：ethereum、bsc、base、starknet、linea、mantle、scroll、zksync、celo。”

工具：listSupportedFeeds

• 描述：以 Markdown 列表形式返回所有受支持的链及其价格数据名称。

• 参数：无。

• 自然语言示例（Claude Desktop）：

  输入：“能列出此服务支持的所有价格数据吗？”

  输出：“以下是各链支持的价格数据：

  • Ethereum：FIL/ETH、FDUSD/USD、UNI/ETH、...
  • BNB Chain：DOT/USD、CAKE/USD、BUSD/BNB、...
  • Base：AXL/USD、USDC/USD、WIF/USD、...
  • Starknet：ETH/USD、BTC/USD、WSTETH/ETH、...
  • Linea：ETH/USD、FOXY/USD、MATIC/USD、...
  • Mantle：MNT/USD、USDT/USD、BTC/USD、...
  • Scroll：SCR/USD、STETH/USD、WBTC/BTC、...
  • zkSync：ZK/USD、PEPE/USD、TRUMP/USD、...
  • Celo：CELO/USD、CUSD/USD、NGN/USD、...”

工具：listSupportedFeedsByChain

• 描述：返回指定区块链网络所支持价格数据名称的逗号分隔列表。

• 参数：

  • chain（string）：区块链网络，例如 base。

• 自然语言示例（Claude Desktop）：

  输入：“Base 链上有哪些可用的价格数据？”

  输出：“Base 链支持以下价格数据：AXL/USD、USDC/USD、WIF/USD、CBETH/ETH、...”

许可证

此项目采用 MIT License 许可。