SuperAPI AI 工具集

build-codemodekit-server

编程与开发

查看项目

更新于 10-16 06:39

技能介绍

用途

本技能用于构建、改造、调试或验证 CodeModeKit 的 Code Mode MCP 服务器。它面向三类来源:应用自有的 Local Tools、stdio MCP 命令,以及远程 MCP URL。核心思路是先为用户真实源码搭建一个可运行的“行走骨架”(walking skeleton),再通过下游 MCP 接口验证其行为,同时把模型生成的代码限制在 CodeModeKit 沙箱内,把宿主集成放在工具提供者之后。

主要能力

  • 检查仓库、包管理器、本地说明、现有 MCP 配置和相关应用函数,且不覆盖无关工作。
  • 选择来源边界:应用自有的函数或 API 使用 Local Tools;无 shell 的可执行文件与参数数组使用 mcp.stdio;Streamable HTTP MCP 端点使用 mcp.http;当一个程序需要多个命名空间时可组合多个来源。
  • 新项目优先使用生成器(参见 references/generator.md 了解命令与生成文件归属)。
  • 改造或自定义服务器时,阅读 references/server-api.md,保留开箱即用的 facade,仅在用户需要专家级覆盖时才暴露编译器或沙箱配置。
  • 定义明确的工具策略,在启用写入、处理凭据或将 Streamable HTTP 绑定到回环之外前,先阅读 references/policy-and-security.md。
  • 保持初始实现紧凑,默认使用单个 src/server.mjs,仅当领域代码已有自然模块边界时才拆分。
  • 若项目包含 Agent Plugin,运行目录同步与构建,但不假装生成的运行时技能理解领域;服务器可用后调用 $author-codemode-skill。
  • 使用 references/verification.md 验证下游行为,实际执行 run_typescript,而不仅是导入或直接调用提供者函数。

使用方式

行走骨架的完成标准是:一次真实的下游执行跨越编译、QuickJS、策略、桥接和所选提供者,并返回预期的有界值。

Local Tool 质量要求:

  • 为工具提供稳定、面向动作的名称和描述,使其能与同类工具区分。
  • 使用有界的输入和输出 schema;项目已使用 Standard JSON Schema 兼容 schema 时优先沿用,普通 JSON Schema 无需额外依赖。
  • 返回纯 JSON 值,并在结果形状稳定时声明输出 schema。
  • 对 fetch 及其他可取消工作使用执行上下文的 signal。
  • 仅当 ToolError 的消息对模型生成的代码安全时才抛出;不要在其中包含凭据、原始上游响应、堆栈跟踪或内部路径。
  • 将认证和网络访问保留在受信任的宿主函数中;绝不要为了让工具工作而向沙箱添加环境级 fetch、文件系统、进程或包访问。
  • 准确标注只读、破坏性、幂等和开放世界注解;注解是策略提示,不是授权。

适用场景

适用于需要为应用自有函数或 API 构建 Code Mode MCP 服务器、将 stdio MCP 命令或远程 MCP URL 接入 CodeModeKit、对已有服务器进行改造或调试,以及通过下游 MCP 接口验证服务器行为的开发场景。

限制

完成标准要求:依赖安装且类型检查或语法检查通过;服务器对外提供 run_typescript,且除非有意禁用否则提供 search_tools;至少一次真实的 TypeScript 执行调用所配置来源并返回有界值;策略拒绝和代表性无效输入能安全失败;插件目录同步为最新,或记录确切的连接阻塞原因;请求 Agent Plugin 时 dist/plugin 能构建;领域感知的运行时技能已编写,或明确报告为需要 $author-codemode-skill 的生成基线。未满足这些条件前,不应宣称服务器已就绪。