区块链API服务

一个基于Node.js的REST API服务器,用于与Monad Testnet区块链网络交互,提供基本的区块链操作功能。

  • by zaki9501
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 zaki9501/pikimon-mcp-server

使用说明

MCP服务器

用于与Monad Testnet区块链网络交互的Node.js服务器。该服务器为常见的区块链操作提供REST API接口。

特性

  • Express.js REST API
  • Web3.js集成用于区块链交互
  • 环境变量配置
  • 基本的区块链操作(获取余额、发送交易等)
  • 安全中间件(头盔、cors)
  • Swagger API文档
  • Docker支持

先决条件

  • Node.js(v16或更高版本)或Docker
  • 如果不使用Docker,则使用npm(v8或更高版本)
  • 访问Monad测试网节点

安装

标准安装

  1. 克隆存储库:

    git clone <repository-url>
    cd mcp-server
    
  2. 安装依赖项:

    npm install
    
  3. 创建环境文件:

    cp .env.example .env
    
  4. 在中配置环境变量 .env:

    • 集 MONAD_RPC_URL 到您的Monad测试网节点URL
    • 集 PORT 如果您想使用其他端口
    • 添加 PRIVATE_KEY 如果需要签署交易

Docker安装

  1. 克隆存储库:

    git clone <repository-url>
    cd mcp-server
    
  2. 创建和配置环境文件:

    cp .env.example .env
    # Edit .env with your configuration
    
  3. 构建Docker镜像:

    docker build -t mcp-server .
    
  4. 运行容器:

    docker run -d \
      --name mcp-server \
      -p 3000:3000 \
      --env-file .env \
      -v $(pwd)/logs:/app/logs \
      mcp-server
    

用法

标准用法

启动开发服务器:

npm run dev

启动生产服务器:

npm start

Docker使用

启动容器:

docker start mcp-server

停止容器:

docker stop mcp-server

查看日志:

docker logs mcp-server

API文档

API文档可在 /api-docs 当服务器正在运行时。访问:

http://localhost:3000/api-docs

API终点

  • 获取 /health -检查服务器运行状况
  • 获取 /blockchain/latest-block -获取当前区块编号
  • 获取 /blockchain/analyze-block/:blockNumber -获取块分析
  • 发布 /blockchain/store-data -将数据存储在合同中
  • 获取 /blockchain/get-data -获取存储的数据
  • 发布 /actions/execute-chain -执行操作链
  • 获取 /actions/parallel-block-analysis -分析多个块

环境变量

变量 描述 默认值
端口 服务器端口 3000
NODE_ENV 环境模式 开发
MONAD_RPC_URL MONAD测试网RPC URL http://localhost:8545
CONTRACT_ADDRESS 智能合约地址 -
CONTRACT_ABI 智能合约ABI -
LOGLEVEL 日志记录级别 信息

Docker卷

容器使用以下体积:

  • /app/logs:包含应用程序日志(组合.log和error.log)

许可证

国际协调委员会