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 分