使用说明

项目简介

本项目是一个Web3 MCP服务器，旨在为大型语言模型（LLM）客户端提供访问加密货币信息的能力。通过实现 Model Context Protocol (MCP)，该服务器允许LLM客户端调用预定义的工具来获取实时的加密货币数据，例如代币价格和详细信息。

主要功能点

提供加密货币价格查询工具: 允许LLM查询指定代币的当前价格。
提供加密货币信息查询工具: 允许LLM查询指定合约地址的代币详细信息 (示例数据).
基于MCP协议: 使用标准的MCP协议与LLM客户端进行通信。
使用CoinMarketCap API: 利用 CoinMarketCap API 获取实时的加密货币数据 (价格查询工具)。
易于配置和部署: 提供简单的安装和配置步骤，方便用户快速部署和使用。

安装步骤

安装 Node.js 和 Yarn: 确保你的开发环境中已安装 Node.js 和 Yarn 包管理器。

克隆仓库: 将 'mcp-server-web3' 仓库克隆到本地。

git clone https://github.com/tdergouzi/mcp-server-web3.git
cd mcp-server-web3

安装依赖: 在仓库根目录下运行 'yarn' 命令安装项目依赖。
```
yarn install
```
构建项目: 运行 'yarn build' 命令构建项目，生成可执行的 'index.js' 文件。
```
yarn build
```

服务器配置

要将此MCP服务器配置到MCP客户端（例如 Claude），你需要在客户端的配置文件中添加服务器配置信息。对于 Claude Desktop 客户端，配置文件通常位于 '~/Library/Application Support/Claude/claude_desktop_config.json' (macOS) 或相应的用户配置目录下。

在 'claude_desktop_config.json' 文件的 'mcpServers' 字段中，添加以下JSON配置。请根据你的实际情况修改路径和API密钥。

{
    "mcpServers": {
        "web3": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-server-web3/build/index.js"],
            "env":{
              "CMC_API_KEY": "YOUR_COINMARKETCAP_API_KEY"
            }
        }
    }
}

配置参数说明:

'server name': 'web3' (服务器名称，客户端配置中引用)
'command': 'node' (启动服务器的命令，这里使用 Node.js 运行时)
'args': '["/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-server-web3/build/index.js"]' (启动命令的参数，指向构建后的 'index.js' 文件绝对路径。请务必替换为你的实际路径)
'env': '{"CMC_API_KEY": "YOUR_COINMARKETCAP_API_KEY"}' (环境变量配置，'CMC_API_KEY' 用于 CoinMarketCap API 密钥。请替换为你在 CoinMarketCap 申请的API密钥)

重要提示:

'/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-server-web3' 必须替换 为 'mcp-server-web3' 项目父目录的绝对路径。
'YOUR_COINMARKETCAP_API_KEY' 必须替换 为你从 CoinMarketCap开发者平台获取的 API 密钥。

基本使用方法

配置完成后，MCP客户端 (如 Claude) 即可连接到此 Web3 MCP 服务器。在与LLM对话时，你可以指示LLM使用已注册的工具来查询加密货币信息。例如，你可以向 Claude 提出如下问题：

"比特币 (BTC) 现在的价格是多少？" (Claude 可能会调用 'get_token_price' 工具查询 BTC 的价格)
"关于合约地址为 [合约地址] 的代币，你能告诉我什么信息？" (Claude 可能会调用 'get_token_info' 工具查询代币信息)

服务器会将查询结果返回给LLM客户端，并作为上下文信息用于生成回复。

关键词