القائمة
使用 Node/TypeScript SDK 构建 MCP (Model Context Protocol) 服务器 —— tools、resources、prompts、Zod 验证、stdio vs Streamable HTTP。需要最新 API 时查询 Context7 或官方 MCP 文档。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
何时使用需要为编程项目、monorepo 或多级目录创建/更新 AGENTS.md、CLAUDE.md 软链接、项目级 agent 操作手册、子目录局部规则、验证命令和 Coding Agent 上下文边界时使用。
分析代码库结构并生成中文 token-lean 架构文档。
用于构建或维护个人 LLM 驱动的知识库。触发词：将资料导入 wiki、查询 wiki 知识、检查 wiki 质量、'添加到 wiki'、'我了解什么关于'，或任何提到 'LLM wiki' 的场景。
当有书面实施计划要在单独会话中执行并带审查检查点时使用
用户明确要求隔离工作区、并行分支验证或临时试验时使用 - 创建隔离的 git worktree
开始开发编程相关对话时使用 - 建立如何查找和使用 skills，在做出任何响应前要求先检查适用的 skill
| name | dev-mcp-patterns |
| description | 使用 Node/TypeScript SDK 构建 MCP (Model Context Protocol) 服务器 —— tools、resources、prompts、Zod 验证、stdio vs Streamable HTTP。需要最新 API 时查询 Context7 或官方 MCP 文档。 |
Model Context Protocol (MCP) 让 AI 助手能够调用工具、读取资源和使用来自你服务器的 prompts。使用此 skill 构建或维护 MCP 服务器。SDK API 会演进；通过 Context7 (query-docs for "MCP") 或官方 MCP 文档检查当前方法名和签名。
使用场景：实现新的 MCP 服务器、添加工具或资源、选择 stdio vs HTTP、升级 SDK、调试 MCP 注册和传输问题。
registerTool() 或 tool() 注册，取决于 SDK 版本。registerResource() 或 resource() 注册。处理器通常接收 uri 参数。registerPrompt() 或等效方法注册。Node/TypeScript SDK 可能暴露 tool() / resource() 或 registerTool() / registerResource()；官方 SDK 随时间变化。始终根据当前 MCP 文档 或 Context7 验证 @modelcontextprotocol/sdk 签名，避免复制粘贴错误。
对于本地客户端，创建 stdio transport 并传递给你服务器的 connect 方法。确切 API 因 SDK 版本而异（例如 constructor vs factory）。查询官方 MCP 文档或 Context7 "MCP stdio server" 获取当前模式。
保持服务器逻辑（tools + resources）独立于 transport，这样你可以在 entrypoint 中插入 stdio 或 HTTP。
对于 Cursor、云端或其他远程客户端，使用 Streamable HTTP（根据当前 spec 的单个 MCP HTTP 端点）。仅当需要向后兼容时才支持遗留 HTTP/SSE。
npm install @modelcontextprotocol/sdk zod
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { z } from "zod";
const server = new McpServer({ name: "my-server", version: "1.0.0" });
使用你的 SDK 版本提供的 API 注册工具和资源：某些版本使用 server.tool(name, description, schema, handler)（位置参数），其他使用 server.tool({ name, description, inputSchema }, handler) 或 registerTool()。Resources 同理 —— 当 API 提供时在处理器中包含 uri。查询官方 MCP 文档或 Context7 获取当前 @modelcontextprotocol/sdk 签名，避免复制粘贴错误。
使用 Zod（或 SDK 首选的 schema 格式）进行输入验证。
@modelcontextprotocol/sdk (npm)。使用 Context7 库名 "MCP" 获取当前注册和传输模式。modelcontextprotocol/go-sdk)。