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://: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})

可用工具

证据包

透明度加密审计跟踪：

{
  "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

黑客马拉松评估对齐

许可证

麻省理工学院

______________________________________________________________________

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