Federated Ai Commons

io.github.Toby-Self由 GitHub 账号 Toby-Self 发布v0.1.1更新于 Oct 24, 2026

MCP server for a federated AI-commons governance simulation with a verified compliance oracle.

已验证STDIO仅桌面数据与分析AI 与机器学习

概览

AI 生成的概览

运行联邦式公地治理的基于智能体模拟,并用抽取出的合规规则检查提议的行动。

可以做什么
  • 运行、比较和扫描基于智能体的治理模拟,可配置参数与随机种子
  • 查询模拟文档并运行项目的回归测试套件
  • 用三条无状态治理合规规则检查提议的行动:紧急状态宣告、资源转移与共享站点延续
  • 对比集中式账本与联邦式点对点资源分配两种架构
适用场景
适合研究或开发公地治理、后稀缺或联邦协调模型的人,让助手运行实验、比较配置并检验某个行动是否符合框架规则。它是风格化的研究模拟,不是生产级治理或安全系统。
运行要求
以本地 Python 进程运行(PyPI 包 federated-ai-commons-mcp,stdio 传输)。README 列出的依赖包括 Mesa、pytest、mcp、networkx 和 numpy,并通过 Python 脚本启动服务。未声明账号、API 密钥或环境变量。
安装前请注意
合规规则被描述为多项信号之一,本身并非安全层,不要用它做访问控制。运行模拟和执行测试套件会占用本地算力,README 也强调该模型是风格化的,无法证明框架在真实机构中可行。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Federated Ai Commons,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Asymptotic Ethics Model

An agent-based simulation testing whether a post-scarcity governance framework — built on Elinor Ostrom's commons-governance principles — actually holds up when implemented and adversarially stress-tested, rather than just argued for in theory. Includes a working MCP server that exposes the simulation as callable tools for AI agents, and a stateless "governance primitive" that lets an agent check whether a proposed action complies with the framework's rules, verified against the simulation's own logic rather than reimplemented from a description of it.

License: Apache 2.0. Core dependency: Mesa (agent-based modeling in Python).


What makes this worth a look

Most of what's genuinely worth reading here isn't the simulation's existence — it's the discipline behind it. Every mechanism was built expecting to find its own failure mode, and several real bugs, exploits, and false conclusions were caught and fixed as a direct result, not hidden after the fact:

  • A hard-threshold emergency-governance mechanic was found to produce permanent crisis rule under default conditions (~70–90% of the time), not occasional intervention — a concrete demonstration of a real AI governance risk. It was redesigned around consent (a citizen vote) rather than force, and the same pattern was later reused for ecological limits and shared-resource conflicts.
  • Democratic policy voting was tested directly and found genuinely vulnerable to capture: free-riding strategies, forming a numerical majority, voted themselves into the most exploitable governance policy — a real result, not a hypothetical concern about democracy.
  • A reputation-reward mechanism was found to let free-riders launder unearned resources into status before being fixed; a barter-economy value function was found to make trading a strictly worse strategy than isolation before being fixed; an evolutionary fitness metric was found to collapse an entire economy into monoculture before being fixed.
  • The "governance primitive" compliance rules are extracted verbatim from the simulation's real decision logic and verified by capturing actual votes and transfers from a live run — not just checked against themselves, which would prove nothing.

The full record of every finding, bug, and fix — in the order it happened — is in FINDINGS.md.


Quick start

bash
pip install mesa pytest mcp networkx numpy
python
from asymptotic_ethics_model import AsymptoticEthicsModel
m = AsymptoticEthicsModel(200, 8, seed=1, coupled_governance=True,                             rehabilitation_enabled=True, graduation_enabled=True)for _ in range(300):    m.step()
df = m.datacollector.get_model_vars_dataframe()df.tail(10)

Run the regression suite before trusting any change:

bash
pytest test_asymptotic_ethics_model.py -v

To run the MCP server (exposes the simulation as tools for an MCP client like Claude Desktop — see the header comment in asymptotic_ethics_mcp_server.py for exact client configuration):

bash
python3 asymptotic_ethics_mcp_server.py

What's in this repo

filewhat it is
asymptotic_ethics_model.pyThe simulation itself — ~2,300 lines, ~132 opt-in parameters across 28 independent subsystems, all defaulted off to preserve baseline behavior.
asymptotic_ethics_mcp_server.pyMCP server exposing the simulation as 9 callable tools: run/compare/sweep simulations, documentation lookup, test-suite execution, and governance compliance checks.
governance_compliance.pyThree stateless compliance rules (emergency declaration, resource transfer, shared-site continuation), each extracted verbatim from the simulation's logic and verified against real captured simulation data.
reference_gateway.pyA worked example of the honest way to consume the compliance rules — as one signal among several (auth, rate limiting, compliance) in a real decision, not as a security layer on its own.
test_asymptotic_ethics_model.py13 persisted regression tests covering the load-bearing findings everything else depends on.
FINDINGS.mdThe full experimental record — every finding, bug, and fix, in order.
LICENSEApache License 2.0.

Architecture

  • Citizen — behavioral strategy, resources, reputation, contribution, relational affinities, experience. Pays effort_cost = contribution ** 2 unless post_labor_economy_enabled.
  • CommunityNode — governance policy, care_load, crisis_severity, emergency_declared, plus (depending on which subsystems are enabled) federated trust/reserves, latency/distance state, and the raw-material economy's production and trade state.
  • SystemLedger — two genuinely separate roles: a migration-decision helper, and ship_raw_materials(), which is structurally blind to everything except raw material levels — verified by direct source inspection in the test suite, not just claimed in a docstring.
  • AsymptoticEthicsModel — orchestrates every subsystem, all opt-in, all defaulted to preserve original behavior when disabled.

Two full resource-allocation architectures exist side by side and are directly comparable: a centralized ledger, and a fully federated network of local commons using peer-to-peer trust-based negotiation — including under simulated communication latency, relevant to any framing involving distributed or off-world coordination.


Honest scope

This is a stylized research simulation — scripted behavioral strategies, not adaptive agents; no physical production; no real politics. It tests whether a governance framework's internal logic holds together and surfaces concrete, reproducible failure modes when you actually try to break it. It does not, and cannot, prove the framework would work if built by real institutions with real humans in them. Read FINDINGS.md for exactly what's been tested, what's been found broken and fixed, and what's still an open question.

来源:README.md,提交 ff2bbcf

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分