AI导哈

DeFi治理分析代理

一个智能代理，使用Cortensor去中心化AI网络分析DeFi治理提案，具有内置验证和加密审计跟踪功能。

  • by calderbuild
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 JasonRobertDestiny/cortensor-governance-agent

使用说明

Cortensor治理代理

黑客马拉松#4提交 -用于DeFi治理分析的MCP客户端

一个智能代理，使用Cortensor去中心化人工智能网络分析DeFi治理提案，具有内置的验证和加密审计跟踪。

亮点

  • MCP 2024-11-05协议 -完整的HTTP流实现
  • 双模客户端 -MCP和REST API支持
  • 信任与验证 -用途 cortensor_validate 用于共识验证
  • 证据包 -用于审计跟踪的SHA-256完整性哈希
  • 生产就绪 -API密钥授权的自托管路由器支持

建筑

+-----------------------------------------------------------+
|                   Governance Agent                         |
|  +------------+   +------------+   +------------------+   |
|  |  Analyze   |-->|  Delegate  |-->|    Validate      |   |
|  |  Proposal  |   |  to Miners |   |    Results       |   |
|  +------------+   +------------+   +------------------+   |
+-----------------------------------------------------------+
         |              MCP / REST API              |
         v                                          v
+-----------------------------------------------------------+
|              Cortensor Router Network                      |
|                                                           |
|   MCP Endpoint: router1-t0.cortensor.app/mcp              |
|   REST API:     http://<your-router>:5010/api/v1/         |
|                                                           |
|   Tools:                                                  |
|   - cortensor_completions (delegate inference)            |
|   - cortensor_validate (verify results)                   |
|   - cortensor_create_session (initialize)                 |
|   - cortensor_miners (list nodes)                         |
+-----------------------------------------------------------+
         |
         v
+-----------------------------------------------------------+
|              Cortensor Miner Network                       |
|        Decentralized LLM inference with PoI + PoUW        |
+-----------------------------------------------------------+

快速开始

# Install
pip install -e .

# Run demo
python demo.py

用法

MCP模式（公共路由器）

from cortensor_agent import CortensorClient, GovernanceAgent

# Connect via MCP protocol
client = CortensorClient(mode="mcp")
client.connect()

# List available tools
tools = client.list_tools()
print(f"Available: {[t['name'] for t in tools]}")

REST模式（自托管路由器）

from cortensor_agent import CortensorClient

# Connect via REST API
client = CortensorClient(
    mode="rest",
    rest_endpoint="http://your-router:5010",
    api_key="your-api-key"
)
client.connect()

# Check status
status = client.get_status()
print(f"Miners: {status.data['connected_miners']}")

治理分析

from cortensor_agent import GovernanceAgent

agent = GovernanceAgent()
agent.connect(session_name="governance-analysis")

# Analyze a proposal
result = agent.analyze_proposal("""
    Proposal: Increase Protocol Fee from 0.3% to 0.5%
    - Additional revenue for treasury
    - Fund security audits
""", validate=True)

print(f"Analysis: {result.analysis}")
print(f"Validated: {result.validated}")
print(f"Score: {result.validation_score}")

# Generate evidence bundle
evidence = agent.generate_evidence_bundle(result)
print(f"Bundle ID: {evidence.bundle_id}")
print(f"Integrity Hash: {evidence.integrity_hash}")

MCP协议实现

HTTP流MCP的关键实现细节：

  1. 初始化 -发送 initialize 请求、捕获 Mcp-Session-Id 从响应标头
  2. 通知 -发送 notifications/initialized （预期无响应）
  3. 工具调用 -包括 Mcp-Session-Id 所有后续请求中的标头
# MCP initialization sequence
resp = POST("/mcp", {"method": "initialize", ...})
session_id = resp.headers["Mcp-Session-Id"]

POST("/mcp", {"method": "notifications/initialized"},
     headers={"Mcp-Session-Id": session_id})

POST("/mcp", {"method": "tools/call", "params": {"name": "cortensor_completions", ...}},
     headers={"Mcp-Session-Id": session_id})

可用工具

工具 方法 说明
cortensor_completions POST 将推理委托给网络
cortensor_delegate POST 用于补全的别名
cortensor_validate POST 通过LLM验证验证结果
cortensor_create_session POST 初始化与节点的会话
cortensor_tasks GET 查询任务历史记录
cortensor_miners GET 列出可用节点
cortensor_status GET 路由器状态
cortensor_about GET 路由器元数据

证据包

透明度加密审计跟踪：

{
  "bundle_id": "eb-abc123def456",
  "analysis": {
    "task_id": "abc123def456",
    "proposal": "Proposal text...",
    "analysis": "Structured analysis...",
    "validation_score": 0.95,
    "validated": true,
    "timestamp": "2026-01-19T10:00:00Z"
  },
  "cortensor_session_id": 12345,
  "raw_responses": [...],
  "validation_responses": [...],
  "integrity_hash": "sha256:a1b2c3d4..."
}

项目结构

cortensor-governance-agent/
├── src/cortensor_agent/
│   ├── __init__.py       # Package exports
│   ├── client.py         # CortensorClient (MCP + REST)
│   └── agent.py          # GovernanceAgent
├── demo.py               # Demo script
├── examples/             # Usage examples
├── tests/                # Test suite
├── docs/                 # Documentation
├── pyproject.toml        # Package config
└── README.md

技术规格

  • 协议：MCP 2024-11-05（HTTP流，而非SSE）
  • 网络：Arbitrum Sepolia测试网（链ID:421614）
  • 语言：Python 3.10+
  • 依赖项: requests

黑客马拉松评估对齐

标准 实施
技术卓越（40%） 全MCP协议，双模客户端，正确的错误处理
信任与验证（25%） cortensor_validate 与SHA-256集成的证据包
用户体验（20%） 简单的API、全面的演示、清晰的文档
生产准备就绪（15%） 自托管路由器支持，API密钥认证，可配置端点

许可证

麻省理工学院

专为Cortensor黑客马拉松#4而建

相关 MCP