Skip to main content
Glama

YodMCP — エージェントオペレーティングシステム

CI Version YodMCP MCP server Python License MCP

YodMCP は、MCP上で動作する本番志向のエージェントオペレーティングシステムカーネルです。マルチグラフメモリ、タスク、スキル、A2A、アテステーション(ソフトウェア / シミュレートTEE)、OpenTelemetry、プランベースのマネタイゼーションを備えています。

このREADMEは、シニアエンジニアがこのファイル+ソースツリーのみで、インストール、全サーフェスのデプロイ、機能の実行、エンドツーエンドの検証を行えるように書かれています。

FOUNDRYマッピング

FOUNDRY(長期的なエージェント群のためのホスト所有の信頼とメモリ)は、信頼されない提案生成を、ホスト所有の検証および確定事実レジストリから分離します。

YodMCPは本番環境におけるそのレジストリです。エージェントは memory_write を呼び出し、セマンティックメモリへの昇格はゲートされ、ホストが評価器を所有します。詳細なノート: docs/FOUNDRY.md。

最初の収益

まずメーターを設置し、ループが成立したら席を確保します。

単位

Stripe

x402

OpenGOS Search $0.40

購入

GET /v1/search

OpenGOS Draft $2.50

購入

GET /v1/draft

Agentic OS Cycle $0.75

購入

GET /v1/cycle

YodMCP Pro $49/mo

登録

USDC

x402レール: x402-cloudflare-starter。デスク同期: https://anamized.grok.me

Related MCP server: Agentic Control Framework (ACF)

パッケージサーフェス

| サーフェス | コマンド | デフォルト | 目的 | |---------|---------|---------| | MCP | yodmcp | stdio | ローカルMCPクライアント(Cursor、Claude Desktopなど) | | MCP HTTP | yodmcp --http --port 8000 | :8000/mcp | リモート / Streamable HTTP MCP | | API | yodmcp-api --port 8080 | :8080 | RESTヘルスチェック、メモリ、監査、スキル、課金 | | A2A | yodmcp-a2a --port 9000 | :9000 | エージェントカード、メッセージ、タスク | | SDK | from yodmcp.sdk import YodClient | HTTPクライアント | API用のシンクライアント | | Skills | skills:// + skills/*/SKILL.md | 自動ロード | MCPリソースとしてのAgent Skills | | Verify | pytest + scripts/verify_e2e.py | CI | Substrate + durable + TEEモード |

要件

  • Python 3.11または3.12(3.10+を宣言済み。CIは3.11/3.12をカバー)

  • オプション: マルチサービスcompose用のDocker

インストール

git clone https://github.com/ANAMIZED/YodMCP.git
cd YodMCP
python -m venv .venv && source .venv/bin/activate   # recommended
pip install -e ".[dev]"

環境デフォルトをコピー:

cp .env.example .env

変数

デフォルト

意味

YODMCP_MEMORY_BACKEND

memory

memory | sqlite | durable

YODMCP_MEMORY_DB

./data/yodmcp_memory.db

durable時のSQLiteパス

YODMCP_ATTEST_MODE

software

software | simulated_tee | nitro | sgx

YODMCP_PLAN

free

free | pro | enterprise

YODMCP_TENANT_ID

default

ソフトクォータのテナントキー

YODMCP_SKILLS_DIR

(自動)

スキルルートを上書き

STRIPE_SECRET_KEY

未設定

ライブCheckoutセッションを有効化

TEEに関する正直な注記: nitro / sgx はプロバイダーフックであり、実際のTEEライブラリがない場合はシミュレートされたクレームにフォールバックします。ローカル検証では software または simulated_tee を推奨します。

クイックスタート(ローカル)

# 1) MCP over stdio (attach from an MCP client)
yodmcp

# 2) REST API
yodmcp-api --port 8080
# curl http://127.0.0.1:8080/health

# 3) A2A
yodmcp-a2a --port 9000
# curl http://127.0.0.1:9000/a2a/card

MCPクライアント設定(stdio)

Cursor — プロジェクトの .cursor/mcp.json、またはグローバルMCP設定:

{
  "mcpServers": {
    "yodmcp": {
      "command": "yodmcp",
      "args": [],
      "env": {
        "YODMCP_MEMORY_BACKEND": "memory",
        "YODMCP_PLAN": "free",
        "YODMCP_ATTEST_MODE": "software"
      }
    }
  }
}

yodmcp が PATH にない場合は、モジュール形式を使用:

{
  "mcpServers": {
    "yodmcp": {
      "command": "python",
      "args": ["-m", "yodmcp"],
      "cwd": "/absolute/path/to/YodMCP",
      "env": {
        "PYTHONPATH": "src",
        "YODMCP_MEMORY_BACKEND": "memory"
      }
    }
  }
}

Claude Desktop — claude_desktop_config.json の mcpServers 配下に同じ構成。

Streamable HTTP MCP(URLトランスポートをサポートするリモートクライアント):

yodmcp --http --host 0.0.0.0 --port 8000
# endpoint: http://127.0.0.1:8000/mcp

Docker

docker compose up --build
# API  :8080  A2A :9000  MCP HTTP :8000

単一APIコンテナ:

docker build -t yodmcp .
docker run --rm -p 8080:8080 -e YODMCP_PLAN=free yodmcp

エンドツーエンドの検証(外部アカウント不要)

# Unit + integration
YODMCP_MEMORY_BACKEND=memory YODMCP_ATTEST_MODE=software \
  PYTHONPATH=src pytest tests/ -v

# Durable SQLite + simulated TEE
YODMCP_MEMORY_BACKEND=sqlite YODMCP_MEMORY_DB=/tmp/yodmcp.db \
  YODMCP_ATTEST_MODE=simulated_tee \
  PYTHONPATH=src pytest tests/ -v

# Exhaustive substrate script
PYTHONPATH=src python scripts/verify_e2e.py

期待される結果: すべてのテストが成功し、スクリプトは ALL E2E CHECKS PASSED を出力します。

APIスモークテスト(yodmcp-api 実行中):

curl -s http://127.0.0.1:8080/health
curl -s http://127.0.0.1:8080/api/skills
curl -s http://127.0.0.1:8080/api/billing/plans
curl -s http://127.0.0.1:8080/api/billing/status

SDK:

python examples/sdk_quickstart.py   # requires API on :8080

MCPツール(カタログ)

ツール

説明

memory_write

メモリノード(事実/決定)を1件挿入します。プランには使用しません(plan_cache_putを使用)。

memory_read

類似度または item_id でノードを取得します。プランには使用しません(plan_cache_getを使用)。

memory_delete

ノード1件と接続エッジを完全削除します。存在しない場合は冪等です。

memory_consolidate

重要度0.8以上のノードをセマンティックサマリーに昇格させます。ソースは削除しません。

memory_stats

ノード/エッジ/エンティティの件数。内容ではありません(memory_readを使用)。

tasks_create

永続的な保留中タスクハンドルを作成します。

tasks_get

IDでハンドルを1件取得します。

tasks_list

最近のハンドルを一覧表示します。ステータスフィルタはオプションです。

tasks_update

ステータス/進捗/結果を更新します。キャンセルではありません(tasks_cancelを使用)。

tasks_cancel

ハンドルをキャンセル済みとしてマークします(カーネル状態のみ)。

tasks_stats

ステータス別の件数。一覧ではありません(tasks_listを使用)。

skills_list

Agent Skillsと skills:// URIを一覧表示します(本文はリソースです)。

a2a_card

A2AエージェントカードJSON。MCPカタログではありません(discover_capabilitiesを使用)。

plan_cache_get / plan_cache_put / plan_cache_delete

セマンティックプランテンプレート。メモリの事実ではありません。

cache_stats

プロセス内キャッシュのエントリ数/ヒット数の合計。

attestation_recent

TRACEスタイルの来歴クレーム。監査証跡ではありません(audit_recentを使用)。

audit_recent

ポリシー/ツールのDecision-System-of-Recordイベント。

discover_capabilities

MCPツールとロード済みスキルを一覧表示します。

echo

死活監視プローブ(message をエコーし、バージョンを返します)。

リソース:

  • skills://{name} — スキルのMarkdown本文

  • yodmcp://agent-card — エージェントカードJSON

スキル

組み込みスキルは常に登録されます。skills/*/SKILL.md 配下のディスクスキルは自動的にロードされます(YODMCP_SKILLS_DIR で上書き可能)。リポジトリに同梱されるスキル:

  • memory-hygiene、safe-tool-use、funding-usdc、repo-bootstrap

  • さらに組み込みの long-horizon-planning

マネタイゼーション

プラン

$/月

ツール呼び出し/日

永続化

TEE

Free

0

500

—

—

Pro

49

50k

あり

シミュレート

Enterprise

499

無制限

あり

Nitro/SGXフック

  • ツールゲートによるソフトクォータ。上限到達時にアップグレードメッセージを表示

  • STRIPE_SECRET_KEY が設定されている場合はライブのStripe Checkout。それ以外の場合、チェックアウトは status: payment_link を返す

非カストディアルUSDC(エージェントに推奨)

ネットワーク

アドレス

Base

0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438

Ethereum

0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438

Solana

ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A

正規: funding/addresses.json

プロジェクト構成

src/yodmcp/          # package (src-layout)
  core/              # server, substrate, context
  memory/            # in-memory + durable SQLite multi-graph
  tools/             # MCP tool registration + gate
  tasks/ skills/ cache/ security/ observability/ monetization/
  api/ a2a/ sdk/
skills/*/SKILL.md    # portable Agent Skills (loaded at runtime)
scripts/verify_e2e.py
tests/
docs/ARCHITECTURE.md
docs/FOUNDRY.md
docs/TDQS.md

既知の制限(本番対応を主張する前にお読みください)

  1. プランキャッシュは軽量な埋め込みを使用します。デフォルトの類似度しきい値は 0.68 です(本番向けのベクトル検索ではありません)。

  2. TEE Nitro/SGXはフックであり、実際のプロバイダーを接続しない限りシミュレートされたフォールバックを使用します。

  3. フロントエンド src/yodmcp/frontend/dashboard.py は依然としてレガシーな core.runtime を使用しており、主要なコントロールプレーンではありません — yodmcp-api + MCPツールを使用してください。

  4. クォータはソフト(プロセス内メーター)であり、分散型の請求台帳ではありません。

  5. プロセスはインメモリ状態を共有しません。マルチプロセスでの永続化には sqlite バックエンド+共有ボリュームを使用してください。

ライセンス

Apache-2.0 · CONTRIBUTING · CHANGELOG · ARCHITECTURE · FOUNDRY · TDQS · AGENTS.md

Available Tools

21 tools
a2a_cardGet A2A Agent CardA
Read-onlyIdempotent

Return this process's A2A Agent Card JSON (name, skills, endpoints) for agent-to-agent interop. Use when another agent needs the card. Do not use to list MCP tools or skills — that is discover_capabilities or skills_list. Read-only, no parameters, no side effects. Auth: tool policy gate.

Inputs: no named parameters. Returns: object

attestation_recentList recent attestation claimsA
Read-onlyIdempotent

Return recent attestation claims issued by this kernel (TRACE-style provenance: tool, allow/deny, risk tier, evidence mode). Use to verify a prior sandbox/TEE decision. Do not use for the policy/audit trail — that is audit_recent. This tool does not issue new claims. Read-only. limit is max claims, newest first (default 10). Auth: gate.

Inputs: limit. Returns: object

audit_recentList recent audit eventsA
Read-onlyIdempotent

Return the newest Decision-System-of-Record audit events (tool calls, policy allow/deny, risk tier, outcome), newest first. Use to inspect what the kernel just decided. Do not use for attestation evidence (attestation_recent) or cache metrics (cache_stats). Read-only. limit caps the list (default 20). Auth: tool policy gate.

Inputs: limit. Returns: object

cache_statsCache statisticsA
Read-onlyIdempotent

Return entry counts and hit totals for the in-process result/plan cache. Use for diagnostics. Do not use to read a plan (plan_cache_get) or memory (memory_read). Read-only, idempotent, no parameters. Auth: tool policy gate.

Inputs: no named parameters. Returns: object

discover_capabilitiesDiscover tools and skillsA
Read-onlyIdempotent

List this kernel's MCP tools and loaded Agent Skills, optionally filtered by a substring query. Use at session start or when unsure which tool to call. Do not use to fetch the A2A interoperability card — that is a2a_card — or skill bodies (read skills:// resources after skills_list). Read-only and idempotent. Auth: gate.

Inputs: query. Returns: object

echoEcho a connectivity probeA
Read-onlyIdempotent

Return the provided message plus server name/version to confirm the MCP session is alive. Use as a liveness probe. Do not use to discover tools (discover_capabilities) or to persist state. Read-only, idempotent, no network I/O, no quota side effects beyond the standard tool gate. message defaults to 'ping'.

Inputs: message. Returns: object

memory_consolidateConsolidate episodic memoryA

Promote high-importance nodes (importance >= 0.8) from from_level into new semantic summary nodes. Use after a burst of memory_write calls to compress working memory. Do not use as a delete — source nodes remain. Mutating, not idempotent (re-running creates additional summaries). Auth: tool policy gate.

Inputs: from_level. Returns: object

memory_deleteDelete a memory nodeA
DestructiveIdempotent

Permanently delete one memory node and its incident edges/entity index rows. Use when a fact must be forgotten. Do not use to hide a node while keeping it — there is no soft-delete. Destructive and idempotent: missing ids return deleted=false. Prefer memory_read first to confirm the id. Auth: policy gate; may require HITL.

Inputs: item_id (required). Returns: object

memory_readRead memory nodesA
Read-onlyIdempotent

Retrieve memory nodes by embedding similarity and/or exact item_id, optionally filtered by level, agent, session, or graph kind. Use to recall stored facts. Do not use for reusable plan templates — that is plan_cache_get. Read-only and idempotent. Returns scored items plus neighbor ids. Auth: tool policy gate.

Inputs: graph, level, limit, query, +3 more. Returns: object

memory_statsMemory graph statisticsA
Read-onlyIdempotent

Return node counts by level plus edge and entity-index sizes for the memory store. Use for capacity/health checks. Do not use to read node content — that is memory_read. Read-only, idempotent, no parameters. Auth: tool policy gate.

Inputs: no named parameters. Returns: object

memory_writeWrite a memory nodeA

Insert one node into the multi-graph memory store (episodic/semantic/procedural) and optionally add causal or entity edges. Use to remember facts, decisions, or session state the host should own. Do not use for reusable task plans — that is plan_cache_put. Mutating and not idempotent: each call creates a new item_id. Gated by plan quota. Nodes with importance >= 0.8 are what memory_consolidate later promotes. Auth: tool policy gate; no network I/O.

Inputs: content (required), level, agent_id, entities, +4 more. Returns: object

plan_cache_deleteDelete a cached planA
DestructiveIdempotent

Delete the exact plan-cache entry for task_description. Use to drop a stale template. Does not delete memory nodes (that is memory_delete). Destructive and idempotent: missing keys return deleted=false. Auth: tool policy gate.

Inputs: task_description (required). Returns: object

plan_cache_getLookup a cached planA
Read-onlyIdempotent

Semantic lookup of a previously stored plan template keyed by task_description. Use to reuse a multi-step plan. Do not use to recall facts from memory (memory_read) or to write a plan (plan_cache_put). Read-only. Returns found, similarity score, and plan. Default similarity threshold is 0.68. Auth: tool policy gate.

Inputs: task_description (required). Returns: object

plan_cache_putStore a plan templateA

Store a structured plan template keyed by task_description for later semantic reuse. Use after you have a working plan. Do not use for episodic facts (memory_write). Mutating; same task_description overwrites the exact key. Auth: tool policy gate.

Inputs: plan (required), task_description (required). Returns: object

skills_listList Agent SkillsA
Read-onlyIdempotent

List loaded Agent Skills with name, skills:// URI, description, and tags. Use to find skill resources to read next. Does not return skill markdown bodies — fetch those via the skills://{name} resource. Do not use for the A2A card (a2a_card). Read-only. Auth: tool policy gate.

Inputs: no named parameters. Returns: object

tasks_cancelCancel a taskA
DestructiveIdempotent

Mark a task cancelled. Use to stop polling a handle you no longer need. Does not kill an external worker process — it only updates kernel state. Destructive relative to the handle, idempotent if already cancelled. Missing ids return cancelled=false. Prefer tasks_get first. Auth: tool policy gate.

Inputs: task_id (required). Returns: object

tasks_createCreate a durable taskA

Create a durable async task handle (pending) that survives process restart when the sqlite tasks backend is enabled. Use to start long-running work you will poll with tasks_get or list with tasks_list. Do not use to store facts (memory_write) or plans (plan_cache_put). Mutating, not idempotent. ttl_ms controls handle expiry hint. Auth: tool policy gate + plan quota.

Inputs: ttl_ms, metadata, tool_name. Returns: object

tasks_getGet a task by idA
Read-onlyIdempotent

Fetch one task handle by task_id (status, progress, result, error). Use to poll after tasks_create. Do not use for aggregate counts — that is tasks_stats — or to list many tasks (tasks_list). Read-only and idempotent. Missing ids return task_not_found. Auth: tool policy gate.

Inputs: task_id (required). Returns: object

tasks_listList recent tasksA
Read-onlyIdempotent

List task handles, newest updated first, optionally filtered by status. Use to recover ids after restart. Do not use to poll a known id (tasks_get) or to mutate state. Read-only and idempotent. Auth: tool policy gate.

Inputs: limit, status. Returns: object

tasks_statsTask store statisticsA
Read-onlyIdempotent

Return total task count and counts by status for the task store. Use for dashboards. Do not use to read a specific handle (tasks_get) or to list handles (tasks_list). Read-only, idempotent, no parameters. Auth: tool policy gate.

Inputs: no named parameters. Returns: object

tasks_updateUpdate a taskA

Patch status, progress, message, result, or error on an existing task. Use while a worker is running. Do not use to cancel — that is tasks_cancel — or to create a new handle (tasks_create). Mutating; last write wins. Missing ids return task_not_found. Auth: tool policy gate.

Inputs: task_id (required), error, result, status, +2 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 21 tools

    Disambiguation4/5

    The tool set is organized into clear subsystems and each description includes explicit 'do not use' cross-references. However, audit_recent and attestation_recent describe very similar recent-decision records, and discover_capabilities vs skills_list vs a2a_card are all discovery-flavored, so a couple of boundaries are easy to blur.

    Naming Consistency3/5

    Most memory_, tasks_, plan_cache_, and skills_ tools follow a readable resource_operation pattern. But discover_capabilities, audit_recent, attestation_recent, a2a_card, and echo break that pattern, resulting in a mixed though still understandable naming convention.

    Tool Count3/5

    With 21 tools, the surface is at the high end and feels heavy for a single server, especially with multiple stats and discovery variants. The broad subsystem coverage justifies most tools, but the overall count is borderline excessive.

    Completeness4/5

    The major subsystems have solid lifecycle coverage: memory has write/read/delete/consolidate, plan cache has get/put/delete, and tasks have create/read/list/update/cancel. Minor gaps remain, such as no hard-delete for tasks and no direct update for memory nodes, but agents can work around them.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers