开发者用Express快速搭建MCP Server 让Claude直接调用本地API

近期，Model Context Protocol（MCP）因统一AI助手与后端通信标准而受关注。一位资深Express开发者验证：无需学习新框架，仅用Express 4、@modelcontextprotocol/sdk、Zod与TypeScript，即可搭建兼容Claude Desktop的MCP Server。核心在于分层架构——将业务逻辑集中于service.ts，通过REST API、MCP stdio与MCP HTTP三入口复用同一套逻辑，实现“一套代码三吃”。以查询GitHub热门仓库为例，service.ts封装了API调用、限频及FALLBACK机制，同时供REST路由与MCP工具调用。MCP本质为JSON-RPC over stdio或HTTP，SDK自动处理协议转换与错误；stdio模式需禁用stdout调试输出以防污染流。部署支持两种方式：stdio适用于本地调试，HTTP/SSE适合云环境，可配Nginx与TLS。实际应用中已集成“接口文档检索”“配置读取”等工具，参数命名清晰（如minutes: int = 10）显著提升模型调用准确率。三大易错点需注意：docstring质量决定调用成功率；参数须前置校验（如Zod防传入字符串）；读操作设超时、写操作加request_id去重。MCP还提升可观测性，统一Client层可集中埋点追踪调用链。结合Ollama v0.40.12对Anthropic API子集的支持，开发者可构建本地闭环：Ollama→Claude Code→Express MCP Server→内部系统，数据不出内网。目前n8n、Cursor、Codeium等已采纳MCP，对Node.js团队而言迁移成本极低，仅需叠加协议适配层即可让AI助手真正执行任务。