YodMCP
YodMCP — エージェントオペレーティングシステム
YodMCP は、MCP上で動作するプロダクション指向のエージェントオペレーティングシステムカーネルです。マルチグラフメモリ、タスク、スキル、A2A、アテステーション(ソフトウェア/シミュレートTEE)、OpenTelemetry、およびプランベースの収益化を備えています。
このREADMEは、このファイルとソースツリーのみを持つシニアエンジニアが、すべてのサーフェスをインストール、デプロイ、機能を実行し、エンドツーエンドで検証できるように書かれています。
パッケージサーフェス
サーフェス | コマンド | デフォルト | 目的 |
MCP |
| stdio | ローカルMCPクライアント(Cursor、Claude Desktopなど) |
MCP HTTP |
|
| リモート/ストリーミング可能HTTP MCP |
API |
|
| RESTヘルスチェック、メモリ、監査、スキル、課金 |
A2A |
|
| エージェントカード、メッセージ、タスク |
SDK |
| HTTPクライアント | API用のシンクライアント |
スキル |
| 自動読み込み | MCPリソースとしてのエージェントスキル |
検証 |
| 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変数 | デフォルト | 意味 |
|
|
|
|
| 永続モード時のSQLiteパス |
|
|
|
|
|
|
|
| ソフトクォータテナントキー |
| (自動) | スキルルートの上書き |
| 未設定 | ライブ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/cardMCPクライアント設定(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 配下で同様の構造。
ストリーミング可能HTTP MCP(URLトランスポートをサポートするリモートクライアント):
yodmcp --http --host 0.0.0.0 --port 8000
# endpoint: http://127.0.0.1:8000/mcpDocker
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/statusSDK:
python examples/sdk_quickstart.py # requires API on :8080MCPツール(カタログ)
ツール | 説明 |
| マルチグラフ階層メモリに永続化 |
| 埋め込み類似度で取得 |
| 高重要度のエピソード記憶を意味記憶に昇格 |
| ノード/エッジ数のカウント |
| 永続的な非同期タスクハンドル |
| エージェントスキル一覧(+ リソースURI) |
| A2AエージェントカードJSON |
| 意味的プランキャッシュ |
| キャッシュ統計 |
| 最近のTRACEスタイルクレーム |
| 最近のポリシー/監査イベント |
| ツールとスキルの段階的発見 |
| 接続確認プローブ |
リソース:
skills://{name}— スキルマークダウン本文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を返す
プラン | リンク |
Pro | |
Enterprise |
非カストディアルUSDC(エージェント推奨)
ネットワーク | アドレス |
Base |
|
Ethereum |
|
Solana |
|
プロジェクト構成
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既知の制限事項(本番環境での使用前に必読)
プランキャッシュは軽量な埋め込みを使用。デフォルトの類似度しきい値は 0.68(本番用ベクトル検索ではありません)。
TEE Nitro/SGXはフックであり、実際のプロバイダーを接続しない限りシミュレートされたフォールバックを使用します。
フロントエンド
src/yodmcp/frontend/dashboard.pyは依然としてレガシーなcore.runtimeを使用しており、主要なコントロールプレーンではありません —yodmcp-api+ MCPツールを使用してください。クォータはソフト(インプロセスメーター)であり、分散型の課金台帳ではありません。
プロセスはインメモリ状態を共有しません。マルチプロセスの永続性には
sqliteバックエンド + 共有ボリュームを使用してください。
ライセンス
Apache-2.0 · CONTRIBUTING · CHANGELOG · ARCHITECTURE · AGENTS.md
Maintenance
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
- Flicense-qualityDmaintenanceEnables deployment of autonomous AI agents with memory and tool execution capabilities through a WebSocket-based MCP protocol. Provides production-ready infrastructure with REST API access, persistent state management, and extensible function registry for building self-hosted AI systems.
- AlicenseDqualityCmaintenanceAI-native orchestration layer with 80+ tools for task management, code editing, browser automation, terminal control, and persistent memory across CLI, local MCP, and cloud deployments.691131ISC
- Alicense-qualityDmaintenanceFoundational MCP/A2A-native core platform for secure credential injection, native x402 micropayments, and Agent-to-Agent routing.2MIT
- Alicense-qualityDmaintenanceA production-ready MCP server that equips AI agents with dynamic, persistent, and executable skills. It enables secure script execution and progressive disclosure to reduce context window usage.15MIT
Related MCP Connectors
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
MCP-native Trust Infrastructure for AI Agents. Persistent encrypted memory with Trust Quotient.
Sovereign Agent OS — Persistent Memory, Governance & Compliance for AI Agents.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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