区块链API服务

Mercata MCP Server是一个区块链API服务,用于与Mercata市场交互,管理资产、质押和储备。

  • by blockapps
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 blockapps/griphook

使用说明

Mercata MCP服务器

Mercata区块链API的MCP服务器,使Claude能够与Mercata市场互动,管理资产、股份和储备。

工具

获取资产的储备详细信息

获取当前的TVL(总价值锁定)、价格以及资产的储备和托管详细信息。

  • 可选输入:
    • assetNames (字符串数组):用于获取TVL、价格以及储备和托管详细信息的资产名称列表
  • 回报:有关准备金的详细信息,包括TVL、价格和托管头寸

获取mercata用户详细信息

获取特定用户的详细个人资料信息。

  • 可选输入:
    • user (string):要查找的用户名(如果省略,则使用当前经过身份验证的用户)
  • 回报:用户的资产和储备,以及详细信息

为用户购买资产

在Mercata区块链上为用户购买资产。

  • 所需输入:
    • asset (string):要购买的资产名称
    • quantity (数字):要购买的数量
  • 退货:购买确认和交易详情

借用usdst供用户使用

从Mercata区块链的储备中为用户借入USDST。

  • 所需输入:
    • reserveAddress (string):要借用的保留地址
    • escrowAddress (string):代表用户在保留区中的位置的托管地址
    • quantity (数字):借款金额
  • 退货:借款确认和交易明细

用户权益资产

将用户的资产抵押在Mercata区块链的储备上。

  • 所需输入:
    • assetName (string):要质押的资产名称
    • quantity (number):要下注的数量
  • 回报:质押确认和交易详情

天气工具

该服务器还包括用于检索天气警报和预报的天气工具:

获取警报

获取美国特定州的天气警报。

  • 所需输入:
    • state (string):两个字母的州代码(例如,CA、NY)
  • 返回:指定状态的活动天气警报列表

获取预报

获取特定位置的天气预报。

  • 所需输入:
    • latitude (数字):位置的纬度
    • longitude (数字):位置的经度
  • 返回:指定位置的详细天气预报

安装

先决条件

需要Node.js 18.0.0或更高版本

克隆存储库:

git clone https://github.com/blockapps/ba-mcp.git
cd ba-mcp

安装依赖项并构建项目:

npm install
npm run build

使用Claude Desktop

查找配置文件

Claude Desktop配置文件通常位于:

  • macOS: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude Desktop\claude_desktop_config.json
  • Linux: ~/.config/Claude Desktop/claude_desktop_config.json

如果文件还不存在,则需要创建它。

配置MCP服务器

将以下内容添加到您的 claude_desktop_config.json 文件:

{
  "mcpServers": {
    "mercata": {
      "command": "/path/to/your/node",
      "args": ["/path/to/ba-mcp/build/index.js"],
      "env": {
        "BA_USERNAME": "your-mercata-username",
        "BA_PASSWORD": "your-mercata-password"
      }
    }
  }
}

例如:

{
  "mcpServers": {
    "mercata": {
      "command": "/Users/username/.nvm/versions/node/v21.7.1/bin/node",
      "args": ["/Users/username/Documents/projects/ba-mcp/build/index.js"],
      "env": {
        "BA_USERNAME": "youremail@example.com",
        "BA_PASSWORD": "yourpassword"
      }
    }
  }
}

环境变量

所需的环境变量:

  • BA_USERNAME:您的Mercata平台用户名
  • BA_PASSWORD:您的Mercata平台密码

可选环境变量:

  • CLIENT_ID:您的OAuth客户端ID
  • CLIENT_SECRET:您的OAuth客户端密钥
  • OPENID_DISCOVERY_URL:OpenID发现的URL
  • MARKETPLACE_URL:Mercata市场的URL

故障排除

如果遇到权限错误,请验证:

  • 您在环境变量中提供了正确的凭据
  • 用户有足够的权限执行您尝试的操作
  • 正在正确检索和使用身份验证令牌

发展

要设置开发环境,请执行以下操作:

  1. 克隆存储库: git clone https://github.com/blockapps/ba-mcp.git
  2. 安装依赖项: npm install
  3. 构建项目: npm run build
  4. 使用正确的凭据运行服务器

许可证

此MCP服务器根据ISC许可证获得许可。有关详细信息,请参阅LICENSE文件。