关于 Unified MCP Client Library for TypeScript
这是一个面向 TypeScript 项目的 MCP 统一客户端库,只需 6 行代码即可让大模型接入 MCP 服务器,快速搭建可私有化部署的 AI 工具代理。它屏蔽了底层协议差异,统一处理握手、能力发现与工具调用,让前端与 Node.js 开发者以最小成本把"工具能力"接入 LLM。
它能做什么
- 一行连接任意兼容 MCP 协议的服务器(stdio / SSE / HTTP 可流式传输)
- 自动列出服务器暴露的 tools / resources / prompts,并注入 LLM 的工具调用 schema
- 统一转发工具调用与结构化结果,自动重连、错误回传与会话状态保持
- 支持私有化部署,可与本地 LLM、内网服务、Ollama、vLLM 等组合使用
- 提供 TypeScript 类型推导,IDE 中可直接看到工具参数与返回结构
是否需要密钥
库本身不需要 API Key 或 Token,属于本地运行的开源客户端 SDK。是否需要密钥完全取决于你连接的 MCP 服务器:
- 本地或内网自建服务器:通常无需密钥,按需配置访问白名单即可
- 第三方托管 MCP 服务:需在其平台注册账号并获取
access_token或 API Key,在初始化 client 时传入 - 涉及企业身份鉴权(OAuth / SSO)时,会在握手阶段跳转登录,无需手动管理长期密钥
建议在 .env 中配置鉴权信息,避免硬编码。