Skip to main content
Glama

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

CI Version Python License MCP

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

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

パッケージサーフェス

サーフェス

コマンド

デフォルト

目的

MCP

yodmcp

stdio

ローカルMCPクライアント(Cursor、Claude Desktopなど)

MCP HTTP

yodmcp --http --port 8000

:8000/mcp

リモート/ストリーミング可能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/*/SKILL.md

自動読み込み

MCPリソースとしてのエージェントスキル

検証

pytest + scripts/verify_e2e.py

CI

基盤 + 永続 + TEEモード

Related MCP server: Agentic Control Framework (ACF)

要件

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

  • オプション: マルチサービスコンポーズ用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

永続モード時の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"
      }
    }
  }
}

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

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

Claude Desktopclaude_desktop_config.jsonmcpServers 配下で同様の構造。

ストリーミング可能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

マルチグラフ階層メモリに永続化

memory_read

埋め込み類似度で取得

memory_consolidate

高重要度のエピソード記憶を意味記憶に昇格

memory_stats

ノード/エッジ数のカウント

tasks_create / tasks_get / tasks_cancel / tasks_stats

永続的な非同期タスクハンドル

skills_list

エージェントスキル一覧(+ リソースURI)

a2a_card

A2AエージェントカードJSON

plan_cache_get / plan_cache_put

意味的プランキャッシュ

cache_stats

キャッシュ統計

attestation_recent

最近のTRACEスタイルクレーム

audit_recent

最近のポリシー/監査イベント

discover_capabilities

ツールとスキルの段階的発見

echo

接続確認プローブ

リソース:

  • skills://{name} — スキルマークダウン本文

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

スキル

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

  • memory-hygienesafe-tool-usefunding-usdcrepo-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

既知の制限事項(本番環境での使用前に必読)

  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 · AGENTS.md

Install Server
A
license - permissive license
C
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ANAMIZED/YodMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server