使用说明
哈沃纳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
许可证
麻省理工学院——见 许可证.