Makuri Showcase (CogniLedger)

CogniLedger MCP 服务 — Makuri 展示

由 CogniLedger Solutions S.R.L.（罗马尼亚布加勒斯特）运营的公开、只读 Model Context Protocol 服务。该服务公开 Makuri EdTech 平台的结构化元数据，包含 11 个工具（9 个信息工具 + 2 个交互式 MCP Apps 面板）、3 个 Markdown 资源和 2 个引导式提示词，涵盖使命、语言、教学方法、定价、安全、合规状况、技术栈、联系渠道以及免费的公开学习资源。

这是一个参考部署，展示了在欧盟合规限制下的生产级 MCP 模式。Makuri 是《欧盟 AI 法案》附件 III 第 3 段所述的高风险 AI 系统（面向未成年人的教育 AI）；因此，本服务 v1 的范围刻意保持有限：仅提供元数据，不含用户数据、个人身份信息（PII）或汇总分析数据。

• 生产端点： https://mcp.cogniledger.eu/mcp
• 许可证： MIT
• 代码仓库： github.com/Cogniledger/cogniledger-mcp-makuri
• 联系邮箱： [email protected]

此服务是什么

• 公开、无需身份验证、只读
• 提供 11 个返回静态元数据的工具（不会针对用户数据执行数据库查询），其中包括 2 个可在兼容宿主中内嵌呈现的交互式 MCP Apps 面板
• 提供 3 个 Markdown 资源（宣言、儿童安全概览、连接指南）和 2 个引导式提示词
• 专为 AI 助手调用而设计，支持 Claude Desktop、Le Chat（Mistral）、Cursor、ChatGPT Apps SDK 及其他支持 MCP 的客户端

此服务不是什么

• 它不是 Makuri 产品。Makuri 的终端用户（儿童、家长）通过 makuri.eu 进行交互，而不是使用此 MCP 服务。
• 它不会公开用户数据、个人身份信息（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	全部 14 种支持的语言区域设置及 UI / AI 导师覆盖标记。可选的 locale 筛选条件。
get_subjects	不依赖教科书的教学方法、十个操作按钮、学习模式。
get_pricing_tiers	免费试用和 Beta 订阅详情。
get_safety_features	年龄门槛、内容过滤器、家长控制、AI 安全防护措施。
get_compliance_matrix	《欧盟 AI 法案》、GDPR、GDPR-K、COPPA、ISO 42001——当前状态及免责声明。可选的 regulation 筛选条件。
get_tech_stack	前端、后端、数据库、AI 提供商、欧盟数据驻留。
get_contact_info	按用途分类的联系渠道。可选的 purpose 筛选条件。
get_free_resources	无需注册即可使用的免费 Makuri 资源：Slovarik 词汇表，以及两种形式的罗马尼亚语水平测试（快速检查，共 20 题，无需邮箱；深度诊断，共 60 题，需提供邮箱并可获得证书）。
show_how_makuri_works	交互式 MCP Apps 面板，介绍 Makuri 的学习流程和十个操作按钮（ui://makuri/how-it-works）。
show_romanian_quiz	交互式 MCP Apps 面板：罗马尼亚语迷你测验，从 15 题题库中随机抽取 10 题（A1–B2 级别），支持 RU/UK 界面切换、逐题答案解析、近似级别评估，以及跳转至完整免费水平测试的行动号召（ui://makuri/romanian-quiz）。

资源

服务器通过 MCP resources/list / resources/read 暴露三篇 Markdown 文档：

• makuri://docs/manifesto — 创始人撰写的宣言，阐述 Makuri 存在的原因。
• makuri://docs/safety-overview — 儿童安全设计措施（账户模型、数据最小化、AI 行为控制）。
• makuri://docs/connect-guide — 如何在 ChatGPT、Claude 和 Le Chat 中连接此服务器。

（对于支持 MCP Apps 的宿主，上方两个交互面板也会作为资源在 ui://makuri/how-it-works 和 ui://makuri/romanian-quiz 中暴露。）

提示词

通过 prompts/list 提供两个引导式提示词：

• 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

使用 streamable-http 传输连接到 http://localhost:3000/mcp。所有 11 个工具都应可见且可调用，此外还有 5 个资源和 2 个提示词。

安全与合规

• 仓库中不包含任何密钥。.env 已被 git 忽略；.env.example 仅列出变量名称，v1 中内容为空。
• 不调用外部 API，不查询数据库，也不进行身份验证。v1 只读取静态数据。
• 每个工具的结构化日志记录会在每次调用时输出一行 JSON，仅包含五个字段：evt、tool、ts、status、duration_ms。不记录请求正文、IP 或参数值。
• 完整的合规立场请参阅 docs/COMPLIANCE_DISCLOSURE.md。

许可证

MIT — 参见 LICENSE。

版权所有 © 2026 CogniLedger Solutions S.R.L.