ued
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"jdcloudSearch": {
"type": "sse",
"url": "https://agentrs.jd.com/mcp/22f9274cb547fae32103d7371cfe6bf5/sse"
}
}
}
服务介绍
MCP TypeScript SDK
[!IMPORTANT]
这是包含SDK v2版本的main分支(目前处于开发阶段,预alpha版)。我们预计在2026年第一季度发布稳定的v2版本。在此之前,v1.x版本仍然是生产环境中推荐使用的版本。v2发布后至少6个月内,v1.x将继续接收错误修复和安全更新,以便用户有时间进行升级。
有关v1文档和代码,请参阅
v1.x分支。
概述
模型上下文协议(MCP)允许应用程序以标准化的方式为LLM提供上下文,将提供上下文的关注点与实际的LLM交互分离。
此仓库包含了MCP规范的TypeScript SDK实现,并提供了以下内容:
- MCP 服务器库(工具/资源/提示、可流式传输的HTTP、标准输入输出、认证辅助)
- MCP 客户端库(传输、高级辅助、OAuth辅助)
- 可运行的示例(位于
examples/下)
包
此单体仓库发布了拆分的包:
@modelcontextprotocol/server: 构建MCP服务器@modelcontextprotocol/client: 构建MCP客户端
两个包都有一个必需的对等依赖 zod 用于模式验证。SDK内部从 zod/v4 导入,但仍然兼容使用Zod v3.25+的项目。
安装
服务器
npm install @modelcontextprotocol/server zod
客户端
npm install @modelcontextprotocol/client zod
快速开始(可运行示例)
可运行的示例位于 examples/ 下,并与文档保持同步。
- 安装依赖(从仓库根目录):
pnpm install
- 运行一个可流式传输的HTTP示例服务器:
pnpm --filter @modelcontextprotocol/examples-server exec tsx src/simpleStreamableHttp.ts
或者,在示例包内运行:
cd examples/server
pnpm tsx src/simpleStreamableHttp.ts
- 在另一个终端中运行交互式客户端:
pnpm --filter @modelcontextprotocol/examples-client exec tsx src/simpleStreamableHttp.ts
或者,在示例包内运行:
cd examples/client
pnpm tsx src/simpleStreamableHttp.ts
下一步:
- 服务器示例子索引:
examples/server/README.md - 客户端示例子索引:
examples/client/README.md - 引导教程:
docs/server.md和docs/client.md
文档
- 本地SDK文档:
- docs/server.md – 构建MCP服务器、传输、工具/资源/提示、CORS、DNS重绑定和部署模式。
- docs/client.md – 使用高级客户端、传输、向后兼容性和OAuth辅助。
- docs/capabilities.md – 抽样、引出(表单和URL)和实验性的基于任务的执行。
- docs/faq.md – 环境和故障排除常见问题解答(包括Node.js Web Crypto支持)。
- 外部参考:
v1(旧版)文档和修复
如果您正在使用v1代的SDK,v1文档(以及任何v1特定的修复)位于长期存在的v1.x分支上。请参阅:
https://github.com/modelcontextprotocol/typescript-sdk/tree/v1.x。
贡献
欢迎在GitHub上提交问题和拉取请求:https://github.com/modelcontextprotocol/typescript-sdk。
许可证
本项目采用MIT许可证—详情请参见LICENSE文件。