Kujolang.ai MCP

Kujolang.ai MCP 服务

版本 0.2.0 是此只读目录服务的加固预览版。源代码发布版本和托管目录各自独立迭代；请检查 /health 和生成的来源凭据，以了解当前目录。相关评审文档中仍记录着现有的运维和互操作性限制。

kujolang-mcp 是一个只读的模型上下文协议服务，用于发现 Kujo 项目、原语、工具、展示案例、Agent 技能、工作流和经过审核的安装指南。原生运行时和目录生成器以 Kujo 编写。生成的 Cloudflare 适配器包含用于托管和汇总遥测数据的 JavaScript。

此仓库是 Kujolang.ai 目录服务，而非可复用的 kujolang/mcp 框架。它遵循该框架的惯例，同时保持独立部署和针对特定产品的特性。

就绪情况

此仓库包含原生参考服务和生成的 Cloudflare Worker 目标。公开的 MCP 目录接口范围明确、无状态、确定且只读。托管适配器另行维护每日汇总分析计数器。Worker 由 Kujo 定义和经过审核的目录生成；Cloudflare 执行的是生成的 JavaScript 构件，而非 Kujo 源代码。这并不代表已通过正式的企业认证。

部署验证通过后，公开 URL 为 https://mcp.kujolang.ai/mcp，健康检查地址为 https://mcp.kujolang.ai/health。始终可以在本地使用。

Agent 可以做什么

• 了解 Kujo 和当前公开目录。
• 列出并搜索项目、原语、工具、展示案例、技能和工作流。
• 获取包含来源链接、安装文本、版本和范围说明的准确记录。
• 针对具体工作获取精简且确定的技术栈建议。
• 查看默认、分组和完整的安装配置文件，但不执行它们。
• 发现 WebOps 功能，避免无关搜索结果占用结果数量限制。

全部七个工具均为只读、确定且幂等。没有写入工具、任意 URL 抓取器、文件系统路径输入、Shell 输入、软件包安装器、部署操作或读取机密的功能。

快速开始

在本地运行

使用支持 run、test 和 HTTP 标准库的 Kujo 运行时：

cd /path/to/kujolang-mcp
kujo run server.kujo -- --self-check
kujo run server.kujo

本地端点为 http://127.0.0.1:8941/mcp；/mcp/v1 是兼容性别名，/health 是健康检查端点。

如需使用本地 Streamable HTTP 客户端：

{
  "mcpServers": {
    "kujolang": {
      "type": "http",
      "url": "http://127.0.0.1:8941/mcp"
    }
  }
}

此服务声明支持 MCP 2026-07-28 和握手时期的 2025-06-18。生产配置会为 2026 请求启用严格的 Mcp-Method 和 Mcp-Name 绑定。

通过 GitHub MCP Registry 快速安装

Kujolang.ai MCP 已列入 GitHub MCP Registry。如需快速连接托管服务，请打开该页面，选择 Install MCP server，并按照所用客户端的说明操作。

如需手动设置，请在客户端中添加远程 MCP 服务：

• 名称： kujolang
• 传输方式： Streamable HTTP
• URL： https://mcp.kujolang.ai/mcp

托管目录无需客户端凭据或本地安装软件包。请按照上方的本地说明，在自己的计算机上运行此服务。

MCP Registry 发布

server.json 将官方 MCP Registry 的托管服务描述为 io.github.kujolang/kujolang-mcp。它与 mcp-server.json 中的原生运行时配置以及 mcp.manifest.json 中的 Kujo 清单相互独立。

Registry 条目 独立于此源元数据。请验证并发布每个经过审核的版本，以更新 Registry；提交此文件并不会发布条目。元数据指向 https://mcp.kujolang.ai/mcp。

在此目录中安装官方发布工具并验证元数据：

brew install mcp-publisher
mcp-publisher validate

如需发布，请使用拥有 kujolang 组织的 GitHub 账户进行身份验证，然后发布经过审核的元数据：

mcp-publisher login github
mcp-publisher publish

托管 MCP 目录无需客户端凭据或本地软件包安装。后续发布时，请更新元数据版本，使其与服务版本一致，并在发布前进行验证。发布工具凭据不得提交到 Git。发布到此 Registry 并不保证条目会被收录到 github.com/mcp；申请在 GitHub 上架是单独的步骤。

MCP 接口

工具	用途
get_kujo_overview	介绍 Kujo、目录数量、发现流程和信任边界
list_ecosystem	按类型或类别筛选项目、技能和工作流
search_kujo_catalog	搜索已发布的公共目录元数据
get_catalog_item	获取一个确切条目及其基于源资料的指引
recommend_kujo_stack	针对某项任务返回一组精简且确定性的匹配结果
get_installation	返回默认、核心、AI、质量、展示、运维或完整安装指引
list_webops_capabilities	仅搜索 WebOps 能力集合

六个资源提供概览、项目、技能、工作流、安装和安全数据。三个提示词用于指导技术栈选择、采用规划和 WebOps 发现。

仓库布局

server.kujo                         Thin stable launcher
src/runtime.kujo                    Configuration, modes, and HTTP routing
src/http_security.kujo              Transport guards and security headers
src/protocol.kujo                   JSON-RPC and MCP dispatch
src/registry.kujo                   Tools, resources, and prompts
src/catalog.kujo                    Catalog validation, indexing, and search
data/catalog.json                   Reviewed deterministic catalog snapshot
scripts/sync_catalog.kujo           Kujo-only catalog synchronization
scripts/generate_worker.kujo        Kujo-only Worker generation
dist/worker.js                      Reviewed generated Cloudflare Worker
wrangler.jsonc                      Free-tier Worker deployment configuration
benchmarks/search_benchmark.kujo    Kujo-only search benchmark
tests/                              Kujo test suites and snapshots

根目录级清单、策略、配置、许可证、文档以及轻量启动器仍保留在根目录，因为软件包管理器、运维人员和代码托管平台会在此处查找这些文件。应用实现位于 src/ 下。

目录完整性与同步

捆绑的目录会在启动时针对架构、条目结构、唯一 slug、数量和 SHA-256 内容摘要进行验证。生产请求绝不会读取同级的网站检出目录，也不会获取远程 URL。

从经过审核的 Kujolang.ai 检出目录重新生成或验证目录：

kujo run scripts/sync_catalog.kujo -- --site /path/to/kujolang.ai
kujo run scripts/sync_catalog.kujo -- --site /path/to/kujolang.ai --check

同步器会拒绝重复或格式错误的 slug，以及意外的源 URL 方案。安装配置文件的成员关系通过解析网站的公开安装程序获取，而非手动重复维护。目录修订涵盖记录和安装配置文件；它可检测意外的快照损坏，但不能替代签名发布或人工审核。

当前快照包含 57 个项目、135 项技能和 45 条工作流记录（共 237 条记录；44 个套件加上 Publishing House Operator）。源中没有权威的独立 Agent 目录；与 Agent 相关的项目、SDK、技能和工作流仍按其实际源类型供用户发现，而不会被伪装成虚构的 Agent 记录。

如需了解自主运行的每周 Agent 提示词，它会审核源准确性、更新 GitHub、通过配置的托管工作流部署，并验证线上目录，请参阅 docs/WEEKLY_REFRESH.md。

安全与性能控制

• 搜索字段有长度限制；规范化后的查询词会去重并限制数量，然后才进行目录操作。
• 目录加载时会一次性索引搜索文本和身份字段。
• Host 为必填项，且必须在允许列表中；如果存在浏览器 Origin，则必须与允许列表中的条目完全一致。
• JSON 请求必须使用 application/json，请求体配置有大小限制，信封经过验证，参数必须为对象，并返回确定性错误。
• 响应包含防御性 no-store、no-sniff、frame、referrer、resource 和 content 安全标头。
• 本地速率限制使用有界的对端 IP 分桶，并通过串行处理器准入避免计数器竞争；健康检查不会消耗配额，但仍受过载准入控制。
• 除非明确确认可信入口的限制措施，否则非回环地址启动会失败；公共监听器会拒绝使用应用本地限流器，因为公共配额和整体过载必须在入口处强制执行。

Kujo 1.9.0 将传输缓冲限制为 8 MiB；目录之后会强制执行更小的 128 KiB UTF-8 字节限制。公共原生入口必须在转发前执行更小的限制。Worker 会在解析前限制流式字节数。当前限制、兼容性变更和未经验证的部署门槛，请参阅生产环境加固。

验证

kujo run scripts/sync_catalog.kujo -- --site /path/to/kujolang.ai --check
kujo run server.kujo -- --self-check
kujo run tests/run_all.kujo
kujo run benchmarks/search_benchmark.kujo
kujo run scripts/generate_worker.kujo -- --framework /path/to/mcp
node --check dist/worker.js

生产环境部署要求

明确选择生产环境配置：

KUJOLANG_MCP_CONFIG=mcp-server.production.example.json \
  kujo run server.kujo

可信入口必须：

• 终止 TLS，并且是唯一允许访问 Kujo 监听器的网络对端；
• 在代理转发前限制请求体字节数、连接／读取超时、每个客户端的限流以及全局过载上限；
• 覆盖或丢弃可被伪造的客户端身份标头；
• 仅转发 /mcp 和 /health，并使用完全匹配的公共 Host；
• 提供访问／错误指标、告警、容量限制和事件响应路由。

公共目录有意不要求用户凭据。如果将来引入私有或租户数据、远程获取、写入或执行功能，则必须重新设计此权限模型，并强制进行身份验证。

完整边界说明请参阅 SECURITY.md，下一阶段的生产就绪工作清单请参阅 docs/NEXT_SESSION_REVIEW.md。

许可证

MIT

发布新鲜度

如果存在已发布的组件版本，目录中的 version 和 latest_release_url 会标识该版本。scope_note 用于区分后续默认分支上的工作、预览支持和操作人员要求。目录中的 source_version 指的是 网站版本，而非 Kujo 运行时版本；kujo 条目记录当前运行时版本。私有项目的公开源代码和安装字段保持为空。

9 月 9 日的审查涵盖了组织下全部 86 个公开仓库、135 条已发布的技能记录，以及 0.6.0 发行版中的全部 44 个工作流。源清单位于 evidence/ecosystem-refresh-2026-09-09/。

使用 Kujo 1.9.0 生成原生目录并运行断言测试。Node 用于验证生成的 JavaScript Worker 及其与原生实现的一致性；它不是托管只读目录的运行时依赖。两种服务都不会安装或执行目录内容中返回的命令。

部署后，运行 node tests/production_catalog_test.mjs，将所有公开目录记录和安装配置文件与经过审查的生成版 Worker 进行比较。设置 RECEIPT_PATH 可保留 JSON 回执。这会发送只读 MCP 查询，绝不会执行安装命令。

Kujo 运行时条目列出了已发布的 1.9.0 版本，适用于 Linux x64/arm64、macOS x64/arm64 和 Windows x64，并包含运行时 npm 软件包。Wave C beta 和 Wave D alpha 仍处于实验阶段；参与者 SDK 软件包仍为私有或尚未发布。目录仍为只读，不授予重放权限。

9 月 29 日的配套更新记录了 Workcell、Ability 和 MCP 1.2.0。Preservation、受控的应用程序/STDIO 执行以及 Git 关联仍遵循各自文档所述的实验性边界。Dispatch 发布是独立的。

9 月 29 日的 SSG 更新记录了 SSG 1.1.0、默认启用的实验性公开 WebMCP，以及独立版本化的本地 Ability pack 1.0.0。网站中经过审查的 Kennel 安装指南也已同步。目录仍为只读；它不会执行 SSG 构建或部署网站。

10 月 7 日的 Tribunal 更新记录了 Tribunal 1.0.2、由本地/操作人员控制的加固措施，以及精确的标签版本安装命令。它保留部署认证边界和目录的只读行为。

10 月 8 日新增的 Agent City 记录了 Agent City 0.2.0、其独立安装程序、本地运行范围和源代码链接。使用 get_catalog_item，并设置 slug: "agent-city"，即可获取该记录。目录不会提交任务或执行其安装命令。Howl showcase bundle 提供了基于源代码的离线预览。

10 月 22 日的 Commerce 更新记录了 Commerce 0.5.1、可选的 PostgreSQL 处理及 Square 支付/恢复模块，以及精确的版本化 npm 安装命令。高级功能仍需通过验收门槛。MCP 目录仅用于发现；它不会执行支付或安装软件包。

遥测

托管服务会收集每日汇总使用计数，不收集原始查询或访客身份信息。详情、数据保留期限和选择退出说明请参阅遥测声明。