使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在使 Claude AI 能够与 Chromia 钱包进行交互，从而实现发送 Chromia (CHR) 交易的功能。该服务器通过 MCP 协议向 Claude AI 提供了一个名为 'send-chr' 的工具，允许用户通过自然语言指令指示 Claude AI 发起 CHR 转账。

主要功能点

CHR 交易发送: 通过 'send-chr' 工具，Claude AI 可以根据用户指令，调用 Chromia 钱包功能发送 CHR 代币到指定地址。
MCP 服务器: 实现了标准的 MCP 服务器功能，可以被 MCP 客户端（如 Claude AI）发现和连接。
工具注册与调用: 注册了 'send-chr' 工具，并处理来自 MCP 客户端的工具调用请求。
Goat SDK 集成: 使用 Goat SDK 和 Chromia Wallet SDK 与 Chromia 区块链进行交互，完成交易的实际执行。

安装步骤

克隆仓库

git clone https://github.com/chromindscan/chromia-mcp
cd chromia-mcp

配置环境变量 复制 '.env.sample' 文件并重命名为 '.env'，然后根据需要配置其中的环境变量，特别是 'EVM_PRIVATE_KEY'，这是 Chromia 钱包的私钥，用于授权交易。

cp .env.sample .env
nano .env # 编辑 .env 文件，填入你的 EVM_PRIVATE_KEY 等信息

安装依赖并构建

npm install
npm run build

服务器配置

要将此 MCP 服务器配置到 Claude Desktop App 中，您需要编辑 Claude 的配置文件 'claude_desktop_config.json'。请根据您的操作系统找到该文件（macOS 路径示例已在仓库的 README 中提供）。

在 'mcpServers' 字段中添加一个新的服务器配置项，配置信息如下：

{
    "mcpServers": {
        "chromia-mcp": {
            "command": "node",
            "args": [
                "/PATH_TO_FOLDER/chromia-mcp/build/index.js"
            ]
        }
    }
}

注意:

将 '/PATH_TO_FOLDER' 替换为 'chromia-mcp' 仓库在您电脑上的绝对路径。例如，如果您的仓库在 '/Users/yourname/Documents/chromia-mcp'，则应将 '/PATH_TO_FOLDER' 替换为 '/Users/yourname/Documents/chromia-mcp'。
'command' 字段指定了启动服务器的命令，这里使用 'node' 运行编译后的 'index.js' 文件。
'args' 字段是一个数组，包含了传递给 'command' 的参数，这里是 'index.js' 文件的路径。

基本使用方法

启动 MCP 服务器: 根据上述配置，启动 chromia-mcp 服务器。通常是在终端中执行 'node /PATH_TO_FOLDER/chromia-mcp/build/index.js' 命令 (请替换为您的实际路径)。
重启 Claude Desktop App: 重启 Claude 桌面应用，Claude 应该会自动检测并连接到您配置的 MCP 服务器 'chromia-mcp'。
使用 Claude 发送 CHR: 在 Claude 中，您可以指示它使用 'send-chr' 工具发送 CHR 交易。例如，您可以对 Claude 说：“使用 send-chr 工具发送 100 CHR 到地址 '0xRecipientAddress'”。Claude 将会调用 MCP 服务器来执行交易。

关键词