arifosmcp (Ariffazil)

arifosmcp——宪法MCP服务器实现

已获取 未提供 — *伪造的，不是赠送的* \[ΔΩΨ | ARIF\] 版本： 2026.03.28封| 状态： 主权密封| 权威： 888_法官

______________________________________________________________________

🔗 CANONICAL LINKS（真理之源）

实时服务

GitHub存储库

______________________________________________________________________

📋 加拿大文件（建筑参考）

______________________________________________________________________

🎯 真相快照

什么是arifosmcp？

arifosmcp是 实施 arifOS宪法智能内核的核心——执行13层、运行000-999管道并交付11个大型工具的实际代码。

家长与本文件：

核心功能：

graph LR
    A["User Request"] --> B["MCP Protocol"]
    B --> C["Constitutional Filter
(F1-F13)"]
    C --> D["Tool Execution"]
    D --> E["Audit Log"]
    
    style A fill:#1a1a2e,color:#fff
    style B fill:#16213e,color:#fff
    style C fill:#0f3460,color:#fff
    style D fill:#1a1a2e,color:#fff
    style E fill:#16213e,color:#fff

______________________________________________________________________

🏗️ 体系结构概述

入口点

graph TB
    A["server.py
Universal Entry"] --> B{"FastMCP Version?"}
    B -->|"2.x"| C["server_horizon.py
Proxy Mode
8 tools"]
    B -->|"3.x"| D["runtime/server.py
Full Kernel
11 tools"]
    
    style A fill:#1a1a2e,color:#fff
    style C fill:#16213e,color:#fff
    style D fill:#0f3460,color:#fff

服务器模式

______________________________________________________________________

🚦 实时MCP合同状态

______________________________________________________________________

🔧 工具库存（1200万件工具）

工具参考表

______________________________________________________________________

📝 工具规格

init_anchor（000_init）

目的： 启动制宪会议。

async def init_anchor(
    actor_id: str,
    declared_name: str,
    mode: Literal["init", "seal", "status"] = "init",
    thermodynamic_budget: dict = None,
    architect_registry: dict = None
) -> dict

退货：

{
    "session_id": str,               # UUID
    "omega_0": float,                # Baseline uncertainty ∈ [0.03, 0.05]
    "delta_s": float,                # Baseline entropy
    "telos_manifold": dict,          # Telos vector weights
    "godel_lock": dict,              # Gödel lock status
    "constitutional_context": str,    # AI system prompt
    "philosophy": str,                # Selected quote from atlas
    "vitality_index": float,         # Ψ score
    "verdict_range": str             # "000_SEAL" | "101-499" | "500-899" | "999_VOID"
}

______________________________________________________________________

架构注册表（000_INIT）

目的： 发现工具和宪法约束。

async def architect_registry() -> dict

退货：

{
    "tools": [
        {
            "name": str,
            "band": str,
            "stage": int,
            "constitutional_constraints": ["F1", "F2", ...],
            "input_schema": dict,
            "output_schema": dict
        }
    ],
    "total_count": int,
    "catalog_hash": str               # SHA-256 integrity
}

______________________________________________________________________

物理真实性（111_SENSE）

目的： 现实世界数据中的地面查询。防止幻觉。

async def physics_reality(
    query: str,
    mode: Literal["time", "search", "reality_check"] = "search",
    time_data: dict = None
) -> dict

宪法过滤器： F2（真理）——所有事实主张都需要引用。

______________________________________________________________________

agi_mind（333_mind）

目的： 三阶段Ollama管道的宪法推理。

graph TB
    A["Query"] --> B["Phase 1: FAST
Quick pattern match"]
    B --> C["Phase 2: REFLECT
Deep reasoning"]
    C --> D["Phase 3: DECIDE
Action selection"]
    
    B -->|"F4 Clarity
ΔS ≤ 0"| E["Pass/Fail"]
    C -->|"F2 Truth
F3 Tri-Witness"| E
    D -->|"Constitutional
Prefix"| E
    
    style A fill:#1a1a2e,color:#fff
    style B fill:#16213e,color:#fff
    style C fill:#0f3460,color:#fff
    style D fill:#1a1a2e,color:#fff

async def agi_mind(
    query: str,
    context: dict,
    mode: Literal["think", "reflect", "decide"] = "think"
) -> dict

三个阶段：

宪法前缀：

CONSTITUTIONAL FRAMEWORK (ΔΩΨ | ARIF):
- Δ CLARITY: Reduce entropy. ΔS ≤ 0.
- Ω HUMILITY: Stay in bounds. Ω ∈ [0.03, 0.05].
- Ψ VITALITY: Every action witnessed.

FLOORS ACTIVE: [F1-F13]

______________________________________________________________________

arifOS-kernel（444_ROUT）

目的： 首席指挥——指挥全千人→888 管道。

graph LR
    A["Query"] --> B["1. Parse Intent
111_SENSE"]
    B --> C["2. Ground Reality
physics_reality"]
    C --> D["3. Reason
agi_mind"]
    D --> E["4. Route Action
444_ROUT"]
    E --> F["5. Safety Critique
asi_heart"]
    F --> G["6. Estimate Cost
math_estimator"]
    G --> H["7. Issue Verdict
apex_soul"]
    
    style A fill:#1a1a2e,color:#fff
    style B fill:#16213e,color:#fff
    style C fill:#0f3460,color:#fff
    style D fill:#1a1a2e,color:#fff
    style E fill:#16213e,color:#fff
    style F fill:#0f3460,color:#fff
    style G fill:#1a1a2e,color:#fff
    style H fill:#16213e,color:#fff

async def arifOS_kernel(
    query: str,
    tools: list[str],
    context: dict
) -> dict

______________________________________________________________________

阿西_哈特（666_哈特）

目的： 安全批评——F5 Peace²，F9伦理学，潜在危害。

async def asi_heart(
    action_plan: dict
) -> dict

退货：

{
    "peace_squared": float,          # Must be ≥ 1.0 (F5)
    "c_dark": float,                 # Must be  dict

退货：

{
    "landauer_limit_pJ": float,       # Minimum thermodynamic cost
    "entropy_change": float,         # ΔS (must be ≤ 0 for F4)
    "coherence_score": float,         # System coherence [0, 1]
    "estimated_energy_J": float,      # Total energy estimate
    "shannon_entropy_bits": float     # Information entropy
}

______________________________________________________________________

apex_soul（888_法官）

目的： 最终宪法判决。

async def apex_soul(
    evidence: dict,
    context: dict
) -> dict

退货：

{
    "verdict": str,                   # "000_SEAL" | "101-499" | "500-899" | "999_VOID"
    "floor_scores": {
        "F1": {"passed": bool, "score": float},
        "F2": {"passed": bool, "score": float},
        # ... F3-F13
    },
    "genius_index": float,            # G = A × P × X × E² (≥ 0.80)
    "vitality_index": float,           # Ψ (≥ 1.0 for healthy)
    "witness_cube": float,            # W³ (≥ 0.95)
    "override_available": bool         # 888_JUDGE can always override
}

______________________________________________________________________

vault_ledger（999_SEAL）

目的： 带有Merkle密封的不可变审计存储。

async def vault_ledger(
    data: dict,
    tier: Literal["constitutional", "standard", "transient"] = "standard"
) -> dict

层级：

______________________________________________________________________

工程内存（555_MEM）

目的： Redis支持的会话内存。

async def engineering_memory(
    key: str,
    operation: Literal["get", "set", "delete", "list"],
    value: any = None,
    ttl: int = 3600
) -> dict

______________________________________________________________________

code_engine（--）

目的： 约束Python执行工具操作。

async def code_engine(
    code: str,
    language: Literal["python", "javascript"] = "python",
    constraints: dict = None
) -> dict

安全限制：

• 没有文件系统访问权限
• 无网络访问
• 不创建子流程
• 内存限制：128MB
• 超时：30s

______________________________________________________________________

🌐 API终点

HTTP端点

MCP协议示例

# List tools
curl -X POST https://arifosmcp.arif-fazil.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Call init_anchor
curl -X POST https://arifosmcp.arif-fazil.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"init_anchor",
      "arguments":{
        "actor_id":"test",
        "declared_name":"TestAgent"
      }
    }
  }'

______________________________________________________________________

⚙️ 配置

环境变量

Docker Compose

services:
  arifosmcp:
    build:
      context: .
      dockerfile: Dockerfile
    environment:
      - OLLAMA_URL=http://ollama_engine:11434
      - REDIS_URL=redis://redis:6379/0
      - DATABASE_URL=postgresql://user:pass@postgres:5432/arifos_vault
      - QDRANT_URL=http://qdrant:6333
    ports:
      - "127.0.0.1:8080:8080"

______________________________________________________________________

📁 代码体系结构

目录结构

arifosmcp/
├── README.md                      # ← This file
├── server.py                      # Universal entry
├── server_horizon.py              # Horizon proxy (FastMCP 2.x)
├── pyproject.toml                 # Dependencies
├── requirements.txt               # Pip dependencies
│
├── runtime/
│   ├── server.py                  # Full kernel (FastMCP 3.x)
│   ├── philosophy.py              # 27-zone atlas
│   ├── init_anchor_hardened.py    # Session anchoring
│   ├── tools_hardened_dispatch.py # Tool routing
│   ├── tools_hardened_v2.py       # Mega-tools
│   ├── tools_internal.py          # Internal utils
│   └── thermo_estimator.py        # Thermodynamic math
│
├── core/
│   ├── governance_kernel.py       # Main orchestrator
│   ├── pipeline.py                 # Execution pipeline
│   └── organs/
│       ├── _1_agi.py             # Mind (333_MIND)
│       ├── _2_asi.py             # Heart (666_HEART)
│       └── _3_apex.py            # Soul (888_JUDGE)
│
├── intelligence/
│   └── tools/
│       ├── thermo_estimator.py   # Cost estimation
│       └── wisdom_quotes.py       # Quote integration
│
├── aaa_mcp/                       # FastMCP tool definitions
├── transport/                     # Protocol transport
├── shared/                        # Shared utilities
└── enforcement/                   # Constitutional enforcement

______________________________________________________________________

🛡️ 宪法实施

楼层合规性矩阵

A --> B2["F9 C_dark ≥ 0.50"] A --> B3["F10 + F2 Violation"] A --> B4["Ψ B5["Human Override"]

B1 -.->|VOID| K["999_SEAL HALT"] B2 -.->|VOID| K B3 -.->|VOID| K B4 -.->|VOID| K B5 -.->|VOID| K

style A fill:#ff0000,color:#fff style K fill:#8b0000,color:#fff

KILL_SWITCH_CONDITIONS = [ ("F1_AMANAH", lambda s: s["amanah"] == 0), ("F9_ETHICS", lambda s: s["c_dark"] >= 0.50), ("F10_CONSCIENCE", lambda s: s["f10_violation"] and s["f2_violation"]), ("PSI_COLLAPSE", lambda s: s["vitality_index"] S_before: raise FLOOR_VIOLATION("F4_CLARITY")

### Landauer极限检查

LANDACKER_pJ_per_bit = 2.87 # at room temperature

bits_erased = estimate_bits_erased(operation) cost_pJ = bits_erased * LANDACKER_pJ_per_bit

if cost_pJ > thermodynamic_budget: raise CONSTRAINT_VIOLATION("F8_ENERGY")

### 探索者/保护者双重过程

graph LR subgraph EXPLORER["EXPLORER"] E1["Proposes mutations"] E2["Searches aggressively"] E3["Optimizes capability"] E4["Score: G (Genius)"] end

subgraph CONSERVATOR["CONSERVATOR"] C1["Protects stability"] C2["Rejects risky changes"] C3["Monitors drift"] C4["Score: Ψ (Vitality)"] end

E1 -->|"TENSION"| EQ["EQUILIBRIUM"] C1 -->|"TENSION"| EQ

style EXPLORER fill:#1a4d1a,color:#fff style CONSERVATOR fill:#4d1a1a,color:#fff style EQ fill:#1a1a2e,color:#fff

**双方必须同意进化才能继续。**

______________________________________________________________________

## 🧪 测试

### 宪法合规性测试

docker compose exec -T arifosmcp python3 /dev/stdin << 'PYEOF' import sys sys.path.insert(0, '/usr/src/app')

from arifosmcp.runtime.init_anchor_hardened import init_anchor_hardened import asyncio

async def test(): result = await init_anchor_hardened( mode='status', thermodynamic_budget={'enthalpy': 100, 'entropy': 50}, architect_registry={'resources': [], 'agents': []} ) print('philosophy:', result.get('philosophy')[:100] if result.get('philosophy') else None) print('telos_manifold:', result.get('telos_manifold')) print('godel_lock:', result.get('godel_lock')) print('constitutional_context present:', result.get('constitutional_context') is not None)

asyncio.run(test()) PYEOF

### 健康检查

curl -s https://arifosmcp.arif-fazil.com/health | python3 -m json.tool

______________________________________________________________________

## 📊 监控

### 普罗米修斯指标

|度量|类型|描述|
|--------|------|-------------|
| `arifos_floor_violations_total` |计数器|F1-F13违规计数|
| `arifos_genius_index` |仪表|当前G评分|
| `arifos_vitality_index` |仪表|当前Ψ评分|
| `arifos_omega_bounds` |仪表|电流Ω不确定度|
| `arifos_tool_calls_total` |计数器|工具调用计数|
| `arifos_pipeline_duration_seconds` |柱状图|管道延迟|

### Grafana仪表板

网址：https://monitor.arifosmcp.arif-fazil.com

仪表板：

- 宪法健康（F1-F13合规性）
- 工具使用统计
- 流水线延迟
- 内存使用

______________________________________________________________________

## 🔧 故障排除

### 问题：“模块文件指向站点包”

**症状：** `import arifosmcp` 负载 `/usr/local/lib/python3.12/site-packages/`

**原因：** Dockerfile中的pip安装创建了冲突的包

**修复：** 重建映像或确保卷装载正确

### 问题：“哲学归零”

**症状：** init_anchor返回空哲学

**原因：** 已加载旧网站包版本

**修复：** 重建容器，清除Python缓存

### 问题：“OLLAMA连接失败”

**症状：** agi\\mind返回连接错误

**修复：** `docker compose restart ollama && docker compose logs --tail=20 ollama`

______________________________________________________________________

## 📦 依赖项

### 核心

|包装|版本|用途|
|---------|---------|---------|
| `fastmcp` |≥3.0 |MCP协议|
| `fastapi` |≥0.115|HTTP服务器|
| `uvicorn` |最新|ASGI服务器|
| `redis` |最新|会话内存|
| `psycopg2` |最新| PostgreSQL（可选）|
| `qdrant-client` |最新|矢量数据库（可选）|
| `sentence-transformers` |最新|语义嵌入|
| `ollama` |最新| LLM推理|

### 哲学地图集

|包装|版本|用途|
|---------|---------|---------|
| `numpy` |最新|3D距离计算|
| `scipy` |最新|统计函数|

______________________________________________________________________

## 🚀 部署

### 构建

docker build --no-cache -t arifos/arifosmcp:latest -f Dockerfile .

### 跑

docker compose up -d arifosmcp

### 重建（代码更改后）

docker compose up -d --force-recreate --no-deps arifosmcp

### 完全回流

docker compose build --no-cache arifosmcp && docker compose up -d arifosmcp

______________________________________________________________________

## 📜 API参考摘要

### init_anchor

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "init_anchor", "arguments": { "actor_id": "string", "declared_name": "string", "mode": "init|seal|status" } } }

### 响应架构

{ "session_id": "uuid", "omega_0": 0.03-0.05, "delta_s": "float", "telos_manifold": {}, "godel_lock": {}, "constitutional_context": "string", "philosophy": "string", "vitality_index": "float", "verdict_range": "000_SEAL|101-499|500-899|999_VOID" }

______________________________________________________________________

## 📋 AI代理（AGENTS.md参考）

在此存储库中运行的所有AI代理都必须遵守 [`../AGENTS.md`](../AGENTS.md):

- **规则1 DRY_RUN：** 标有“仅估算/模拟”的试运行输出
- **规则2域_日期：** 无法计算域返回精确短语
- **规则3判断范围：** 只有DOMAIN_SEAL授权事实索赔
- **第4条锚定无效：** init_anchor返回void→ 会话已阻止

______________________________________________________________________

## ⚖️ 真理层次

arifOS判决制度遵循严格的 **真理层次** 其中较高优先级的判决优先于较低优先级的判决：

|优先级|判决|含义|行动|
|----------|---------|---------|--------|
|1（P0）| `VOID` |严重违反宪法|立即终止|
|2（P1）| `HOLD_888` |主权否决权/需要人力|在批准之前予以阻止|
|3（P2）| `SABAR` |接地不足（F7/F9）|暂停、冷却、重新接地|
|4（P3）| `PARTIAL` |数据不完整/有条件|继续修改|
|5（第4页）| `SEAL` |宪法对齐已确认|继续|

**衍生判决** （非主要）：

- `ALIVE` --会话已初始化，尚未接地
- `PROVISIONAL` --探索性结果，需要确认

______________________________________________________________________

## 🗺️ 工具类别

arifOS工具分为 **5个宪法乐队**:

|频带|范围|用途|示例|
|------|-------|---------|----------|
| **内核** |000–099 |会议锚定，宪法初始化| `init_anchor` |
| **感觉** |100–199|环境接地（F2/F4）| `physics_reality`, `math_estimator` |
| **桥** |300–399 |强化路由和调度| `arifOS_kernel` |
| **心智** |333 |宪法推理（F2/F4/F7/F8）| `agi_mind` |
| **心** |666 |安全评价和影响预测（F5/F6/F9）| `asi_heart` |
| **金库** |900–999 |不可变账簿和印章（F1/F13）| `vault_ledger` |
| **顶点** |888 |主权判决和辩护（F3/F12/F13）| `apex_soul` |

______________________________________________________________________

## 🗂️ 合同真实性表

|工具|F1|F2|F3|F4|F5|F6|F7|F8|F9|F10|F11|F12|F13|
|------|----|----|----|----|----|----|----|----|----|-----|-----|-----|-----|
| `init_anchor` | — | — | — | — | — | — | — | — | — | — | ✅ | — | — |
| `physics_reality` | — | ✅ | — | ✅ | — | — | — | — | — | — | — | — | — |
| `agi_mind` | — | ✅ | — | ✅ | — | — | ✅ | ✅ | — | — | — | — | — |
| `asi_heart` | — | — | — | — | ✅ | ✅ | — | — | ✅ | — | — | — | — |
| `apex_soul` | — | — | ✅ | — | — | — | — | — | — | — | — | ✅ | ✅ |
| `vault_ledger` | ✅ | — | — | — | — | — | — | — | — | — | — | — | ✅ |

**传说：** ✅ = 此工具的强制地板

______________________________________________________________________

## 📡 Horizon与VPS风险敞口矩阵

|工具|地平线（外部）| VPS（内部）|备注|
|------|-------------------|----------------|-------|
| `search_tool` | ✅ | — | 外部网络搜索|
| `reality_compass` | ✅ | — | 路由/外部呼叫|
| `vault_ledger` | — | ✅ | 内部Merkle链|
| `agi_mind` | — | ✅ | 内部推理|
| `architect_registry` | ✅ | ✅ | 两个接口均已暴露|

______________________________________________________________________

## ⚠️ 已知的错位和限制

1. **`apex_judge` 别名**：该工具的名称是规范的 `apex_soul` 在代码中，但暴露为 `apex_judge` 通过MCP。这是一个 **公共别名** 这里有文档记录——在未完成完整迁移的情况下，不要重命名规范代码。

1. **`physics_reality` 字段名称**：用途 `input` 字段而不是 `query` -与遗留API的历史不一致。

1. **`check_vital`, `audit_rules`**：内部生命周期工具 `server_horizon.py` 独自创立 **不可通过MCP调用**.

1. **`agi_mind` 嵌套判决**：何时 `agi_mind` 回报 `verdict: "SEAL"` 在顶层，但 `coherence.verdict: "SABAR"` 里面 **最差判决获胜** （真理先于速度）。

1. **`search_tool`, `vault_ledger`, `reality_compass`**：这些“裸”工具返回没有判断包装的原始数据。包裹 `RuntimeEnvelope` 和 `verdict_wrapper.forge_verdict()` --空结果产生 `PARTIAL`，不 `VOID`.

1. **`VerdictCode` 对比 `Verdict`**：存在两个单独的枚举类-- `VerdictCode` （印章/SABAR/部分/无效）用于判决 `Verdict` （包括暂停/有效/临时）阶段合同。保持独立，以避免破坏现有代码。

______________________________________________________________________

## 🛰️ MCP呼叫模式示例

### init_anchor

{ "tool": "init_anchor", "arguments": { "actor_id": "user-123", "declared_name": "Arif", "mode": "init" } }

### agi\\mind（原因模式）

{ "tool": "agi_mind", "arguments": { "mode": "reason", "query": "Why does entropy matter?", "constitutional_context": { "stage": "MIND_333", "floors_active": ["F2", "F4", "F7", "F8"] } } }

### vault_ledger（密封模式）

{ "tool": "vault_ledger", "arguments": { "mode": "seal", "data": { "content": "Verified fact", "metadata": {"source": "arifOS"} } } }

### apex_soul（判断模式）

{ "tool": "apex_soul", "arguments": { "mode": "judge", "action": "seal_vault", "stakes": "HIGH" } }

______________________________________________________________________

## 🔐 稳定性等级

|级别|描述|预期判决|
|------|-------------|------------------|
| **A.** |经过验证，稳定，可投入生产| `SEAL` |
| **B** |已验证、已加固、小问题已解决| `SEAL` 或 `PARTIAL` |
| **C** |已验证的已知限制已记录在案| `PARTIAL` 或 `SABAR` |
| **D** |实验性的、突破性的变化是可能的|任何|
| **内部** |未通过MCP暴露|N/A|

______________________________________________________________________

## 🏛️ 许可证

**运行时间：** AGPL-3.0（必须发布修改）
**理论：** CC0（公共领域）

______________________________________________________________________

**版本：** 2026.03.28封
**维护人员：** 穆罕默德·阿里夫·本·法齐
**宪法权威：** 888_法官

*Forged 没有给予* --锻造，未给出\[ΔΩΨ|ARIF\]

______________________________________________________________________

██╗ ██████╗ ███████╗████████╗ ███████╗███╗ ██╗██╗██╗ ██╗██╗██╗ ██╗██╗ ██╗ ██║ ██╔══██╗██╔════╝╚══██╔══╝ ██╔════╝████╗ ██║██║╚██╗██╔╝██║██║ ██║╚██╗ ██╔╝ ██║ ██║ ██║█████╗ ██║ █████╗ ██╔██╗ ██║██║ ╚███╔╝ ██║███████║ ╚████╔╝ ██║ ██║ ██║██╔══╝ ██║ ██╔══╝ ██║╚██╗██║██║ ██╔██╗ ██║██╔══██║ ╚██╔╝ ███████╗╚█████╔╝███████╗ ██║ ███████╗██║ ╚████║██║██╔╝ ██╗██║██║ ██║ ██║ ╚══════╝ ╚═════╝ ╚══════╝ ╚═╝ ╚══════╝╚═╝ ╚══╝╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝ ╚═╝