手写100行TypeScript MCP Server 实现AI Agent直连后端API

MCP（Model Context Protocol）正成为AI Agent与后端服务对接的新标准。近期实战案例显示，开发者仅用约100行TypeScript代码即可手写一个轻量MCP Server，将自建书签系统linkbox的API封装为AI可调用工具，实现与Cursor、Claude Desktop等客户端的即插即用集成。该方案核心在于解耦：AI客户端通过stdio通道与MCP Server通信，Server负责转发请求至真实后端并处理认证、重试等细节，避免了传统Function Calling中‘一客户端一适配’的重复开发问题。工程结构极简，仅需三个关键文件——index.ts（启动入口，<10行）、client.ts（HTTP封装）、tools.ts（工具定义与Zod校验），依赖仅@modelcontextprotocol/sdk与zod。方案要求Node.js启用ESM支持（package.json设"type":"module"，tsconfig配置"module":"Node16"），导入需显式加.js后缀。MCP能力模型分为Tools（操作型函数）、Resources（只读资料）、Prompts（提示词模板），多数场景只需实现Tools。调试便捷，可通过mcp-inspector可视化查看JSON-RPC请求响应。相比Puppeteer等浏览器自动化方案，MCP基于稳定API契约，可靠性高、延迟低、Token消耗少，适合高频调用场景。当前Cursor与Claude Desktop已原生支持，社区亦提供CLI工具辅助生成定义。该实践已在个人知识管理、运维助手、客服工单等场景落地，部署测试可在15分钟内完成，为中小团队快速释放已有API的AI能力提供了低成本路径。