使用说明

项目简介

Adamik MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在通过 Claude Desktop 等 MCP 客户端，为用户提供统一访问和操作 60 多个区块链网络的能力。它利用 Adamik API 简化了与不同区块链的交互，让用户可以通过自然语言查询和操作区块链数据，例如查询账户余额、交易记录、进行交易、参与 Staking 等。

主要功能点

多链支持: 统一接口访问包括以太坊、Starknet、Cosmos、比特币等 60 多个区块链网络。
交易管理: 支持交易编码、验证、广播和查询交易状态等功能。
账户管理: 提供账户余额查询、代币余额查询和交易历史记录查询等功能。
实用工具: 包含地址验证、公钥到地址转换、链和代币信息检索等实用工具。
Staking 支持: 支持在权益证明区块链上进行 Staking 相关操作，如质押、解质押、领取奖励和查询验证器信息。
代币交互: 支持原生代币和各种标准代币（如 ERC20, TRC20, ASA）的转账和信息查询。

安装步骤

克隆仓库

git clone [email protected]:AdamikHQ/adamik-mcp-server.git
cd adamik-mcp-server

配置环境变量

复制 '.env.example' 文件并重命名为 '.env'。

打开 '.env' 文件，填入你的 Adamik API 密钥。API 密钥可以前往 https://dashboard.adamik.io 注册账号并创建获取。

ADAMIK_API_KEY="your_api_key_here"
ADAMIK_API_BASE_URL="https://api.adamik.io"

安装依赖并构建

pnpm install
pnpm run build

服务器配置

要将 Adamik MCP Server 集成到 Claude Desktop，你需要修改 Claude 的配置文件 'claude_desktop_config.json'。

打开 Claude 配置文件: 通常配置文件位于 '~/Library/Application Support/Claude/claude_desktop_config.json'。如果文件不存在，请创建它。
添加 MCP 服务器配置: 在 'claude_desktop_config.json' 文件中，添加 'mcpServers' 配置项，并配置 Adamik MCP Server。
```
{
  "mcpServers": {
    "adamik-mcp-server": {
      "command": "node",
      "args": ["/Users/YourUsername/GitHub/adamik-mcp-server/build/index.js"]
    }
  }
}
```
配置参数说明:
- 'server name': 'adamik-mcp-server' (服务器名称，在 Claude Desktop 中用于标识和选择服务器)
- 'command': 'node' (启动服务器的命令，这里使用 Node.js 运行时)
- 'args': '["/Users/YourUsername/GitHub/adamik-mcp-server/build/index.js"]' (启动服务器的参数，指向编译后的 'index.js' 文件路径。请务必将 '/Users/YourUsername/GitHub/adamik-mcp-server' 替换为你实际的项目代码路径)
重启 Claude: 配置完成后，重启 Claude Desktop 使配置生效。

基本使用方法

配置完成后，你可以在 Claude Desktop 中通过自然语言指令与区块链网络进行交互。以下是一些示例：

查询 Cosmos 地址余额: 在 Claude 中提问 "Can you get balances of my cosmos address cosmos1yvuhqg73fdzxvam9sj7mazfa38gpn7ulsavh7s?"
多链余额查询: 提问 "Can you check my balances across different chains? - Ethereum: 0x... - Bitcoin: bc1q... - StarkNet: 0x... - TON: UQAQ..."
查询 dYdX 账户最新操作: 提问 "What's my latest operation on my dYdX account dydx1yvuhqg73fdzxvam9sj7mazfa38gpn7uleyzn78?"
查询 Osmosis Staking 奖励: 提问 "What are my current pending rewards on Osmosis address osmo1yvuhqg73fdzxvam9sj7mazfa38gpn7ulcxl8gz?"

更多使用示例和详细功能可以参考仓库的 README 文件和 Adamik API 文档 https://docs.adamik.io。

关键词