Makuri Showcase (CogniLedger)

CogniLedger MCP Server — Makuri のショーケース

CogniLedger Solutions S.R.L.（ルーマニア、ブカレスト）が運営する、公開の読み取り専用 Model Context Protocol サーバーです。Makuri EdTech プラットフォームに関する構造化メタデータを公開します。11 個のツール（情報ツール 9 個＋インタラクティブな MCP Apps パネル 2 個）、3 個の Markdown リソース、2 個のガイド付きプロンプトを提供し、ミッション、対応言語、指導方法、料金、安全性、コンプライアンス状況、技術スタック、問い合わせ窓口、無料の公開学習リソースを網羅しています。

これは、EU のコンプライアンス制約下における本番環境向け MCP パターンを示すリファレンスデプロイです。Makuri は EU AI Act Annex III, paragraph 3 に基づく高リスク AI システム（未成年者向け教育 AI）であるため、このサーバーの v1 の対象範囲は意図的に限定されています。メタデータのみを扱い、ユーザーデータ、PII、集計分析データは扱いません。

• 本番環境のエンドポイント： https://mcp.cogniledger.eu/mcp
• ライセンス： MIT
• リポジトリ： github.com/Cogniledger/cogniledger-mcp-makuri
• 連絡先： [email protected]

このサーバーについて

• 認証不要の公開読み取り専用サーバーです
• 静的メタデータを返す 11 個のツールを提供します（ユーザーデータに対するデータベースクエリは行いません）。対応ホストではインライン表示されるインタラクティブな MCP Apps パネルも 2 個含まれます
• 3 個の Markdown リソース（マニフェスト、子どもの安全に関する概要、接続ガイド）と 2 個のガイド付きプロンプトを提供します
• AI アシスタント（Claude Desktop、Le Chat（Mistral）、Cursor、ChatGPT Apps SDK、およびその他の MCP 対応クライアント）からの呼び出しを想定して設計されています

このサーバーでないもの

• Makuri 製品そのものではありません。Makuri のエンドユーザー（子ども、保護者）は、この MCP サーバーではなく makuri.eu を利用します。
• ユーザーデータ、PII、IP アドレス、行動分析データ、エンドユーザーのアクティビティから得られたデータは公開しません。

接続

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "cogniledger-makuri": {
      "url": "https://mcp.cogniledger.eu/mcp"
    }
  }
}

Claude Desktop を再起動します。コネクター選択メニューにツールが表示されます。

Le Chat（Mistral）

Le Chat の設定で、新しい MCP コネクターを追加します。

• 名前： CogniLedger — Makuri
• トランスポート： streamable-http
• URL： https://mcp.cogniledger.eu/mcp

Cursor

~/.cursor/mcp.json を編集します。

{
  "mcpServers": {
    "cogniledger-makuri": {
      "url": "https://mcp.cogniledger.eu/mcp"
    }
  }
}

ツール

ツール	説明
get_platform_info	ミッション、対象ユーザー、創業に関する詳細、運営会社。
get_supported_languages	UI／AI チューターの対応状況を示すフラグ付きの、対応する全 14 ロケール。任意の locale フィルターを指定できます。
get_subjects	教科書に依存しない指導方法、10 個のアクションボタン、学習モード。
get_pricing_tiers	無料トライアルとベータ版サブスクリプションの詳細。
get_safety_features	年齢確認、コンテンツフィルター、保護者向けコントロール、AI 安全ガードレール。
get_compliance_matrix	EU AI Act、GDPR、GDPR-K、COPPA、ISO 42001 の免責事項付き最新状況。任意の regulation フィルターを指定できます。
get_tech_stack	フロントエンド、バックエンド、データベース、AI プロバイダー、EU データレジデンシー。
get_contact_info	用途別の問い合わせ窓口。任意の purpose フィルターを指定できます。
get_free_resources	登録不要の無料 Makuri リソース：語彙学習用の Slovarik と、2 種類のルーマニア語レベルテスト（Quick Check：20 問、メール不要；Deep Diagnostic：60 問、メールアドレスと修了証明書が必要）。
show_how_makuri_works	Makuri の学習フローと 10 個のアクションボタンを説明する、インタラクティブな MCP Apps パネル（ui://makuri/how-it-works）。
show_romanian_quiz	インタラクティブな MCP Apps パネル：15 問の問題バンクから 10 問をランダムに出題するルーマニア語ミニクイズ（レベル A1～B2）、RU／UK インターフェース切り替え、各回答の解説、おおよそのレベル判定、無料の完全版レベルテストへの CTA（ui://makuri/romanian-quiz）。

リソース

サーバーは MCP の resources/list ／ resources/read を通じて、3 つの Markdown ドキュメントを公開します。

• makuri://docs/manifesto — Makuri が存在する理由について、創設者が執筆したマニフェストです。
• makuri://docs/safety-overview — 子どもの安全を守るための設計上の対策（アカウントモデル、データの最小化、AI の動作制御）です。
• makuri://docs/connect-guide — ChatGPT、Claude、Le Chat でこのサーバーに接続する方法です。

上記のインタラクティブパネル 2 つも、MCP Apps に対応したホスト向けに、ui://makuri/how-it-works と ui://makuri/romanian-quiz のリソースとして公開されています。

プロンプト

prompts/list を通じて、2 つのガイド付きプロンプトを提供します。

• evaluate_makuri_for_my_child(child_age, native_language) — 特定の子どもに適しているかを評価するためのガイドです。
• makuri_safety_briefing() — 「認証済みのコンプライアンスではなく、設計上の方針」という位置付けを明示した、誠実な安全性の説明です。

入力スキーマと応答例の全文は、docs/TOOLS.md をご覧ください。実際のクライアントでの会話記録は、docs/EXAMPLES.md をご覧ください。コンプライアンスに関する開示は、docs/COMPLIANCE_DISCLOSURE.md をご覧ください。

ローカル開発

git clone https://github.com/Cogniledger/cogniledger-mcp-makuri.git
cd cogniledger-mcp-makuri
npm install
npm run dev

サーバーは http://localhost:3000 で起動します。MCP エンドポイントは http://localhost:3000/mcp です。

スモークテスト

# In one terminal:
npm run dev

# In another:
npm run test:smoke

スモークテストはローカルサーバーに接続し、ツールを一覧表示してそれぞれを呼び出し、失敗があればゼロ以外の終了コードで終了します。

MCP Inspector

npx @modelcontextprotocol/inspector

http://localhost:3000/mcp に streamable-http トランスポートで接続してください。11 個のツールすべてが表示されて呼び出し可能になり、さらに 5 つのリソースと 2 つのプロンプトも表示されます。

セキュリティとコンプライアンス

• リポジトリにシークレットはありません。.env は Git の追跡対象外で、.env.example には変数名のみが記載されており、v1 では空です。
• 外部 API 呼び出し、データベースクエリ、認証はありません。v1 は静的データの読み取りのみです。
• ツールごとの構造化ログでは、呼び出しごとに 5 つのフィールドのみを含む JSON の 1 行が出力されます。フィールドは evt、tool、ts、status、duration_ms です。リクエスト本文、IP アドレス、引数の値は記録されません。
• コンプライアンスに関する全体的な方針については、docs/COMPLIANCE_DISCLOSURE.md をご覧ください。

ライセンス

MIT — LICENSE をご覧ください。

Copyright © 2026 CogniLedger Solutions S.R.L.