贸易金融API服务器

为Havona贸易金融API提供的MCP服务器,支持连接MCP兼容的AI助手以访问实时贸易合同、区块链状态和文档提取功能。

  • by havona-labs
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 havona-labs/havona-mcp

使用说明

哈沃纳mcp

MCP服务器 哈沃纳 贸易融资API。将任何兼容MCP的AI助手连接到实时交易合约、区块链状态和文档提取。

工具

工具 说明
list_trades 列出最近的贸易合同
get_trade 按ID获取交易
create_trade 创建新的贸易合同
update_trade_status 更新状态(草稿→ 活跃的→ 已完成)
blockchain_status 检查链连接+合同地址
get_trade_blockchain_record 获取交易的链上确认
list_agents 列出已注册的ERC-8004人工智能代理
get_agent_reputation 获取代理信誉评分
list_supported_document_types 列出可提取的ETR文档类型
extract_trade_document 从PDF中提取字段(AI,无持久性)
graphql_query 原始GraphQL透传

安装

pip install havona-mcp

或来源:

git clone https://github.com/havona-labs/havona-mcp
cd havona-mcp
pip install -e .

配置

复制 .env.example 到 .env:

HAVONA_API_URL=https://api.yourdomain.com
AUTH0_DOMAIN=your-tenant.us.auth0.com
AUTH0_AUDIENCE=https://api.yourdomain.com
AUTH0_CLIENT_ID=your_client_id
HAVONA_EMAIL=trader@yourdomain.com
HAVONA_PASSWORD=your_password

克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "havona": {
      "command": "python",
      "args": ["-m", "havona_mcp"],
      "env": {
        "HAVONA_API_URL": "https://api.yourdomain.com",
        "AUTH0_DOMAIN": "your-tenant.us.auth0.com",
        "AUTH0_AUDIENCE": "https://api.yourdomain.com",
        "AUTH0_CLIENT_ID": "your_client_id",
        "HAVONA_EMAIL": "trader@yourdomain.com",
        "HAVONA_PASSWORD": "your_password"
      }
    }
  }
}

重新启动克劳德桌面。你现在可以问:

“显示我最近的交易” “区块链的现状如何?” “创建50000桶原油的交易草案” “从该商业发票PDF中提取字段”

游标/其他MCP客户端

python -m havona_mcp          # stdio (default)
python -m havona_mcp --sse    # SSE transport for web clients

建筑

Claude Desktop / Cursor
        │  MCP protocol (stdio or SSE)
        ▼
  havona-mcp  (this repo)
        │  Python function calls
        ▼
  havona-sdk
        │  HTTPS + Bearer token
        ▼
  Havona API  →  DGraph + Confidential EVM

许可证

麻省理工学院——见 许可证.