demo

基于TypeScript的MCP服务器演示工具,展示资源查询与工具操作。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:demo。
它的用途是:基于TypeScript的MCP服务器演示工具,展示资源查询与工具操作。
完整的 Skill 内容见:https://321skill.com/skills/demo-demo-mcp-server/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请通过MCP演示工具查询一下服务器状态。”,它会调用该演示服务器暴露的“get_server_info”资源,返回一个包含服务器名称、版本等信息的JSON对象。或者

对AI说:“用演示工具里的计算器算一下15乘以20。”,它会调用“calculate”工具并返回计算结果300。

介绍

这个Skill是一个基于TypeScript开发的MCP(Model Context Protocol)服务器演示工具。它主要解决开发者,特别是刚接触MCP协议的开发者,在理解和学习如何构建一个MCP服务器时面临的“如何开始”和“如何组织代码”的困惑。

它通过提供一套完整的、可运行的TypeScript代码示例,展示了MCP服务器的核心功能,包括如何定义和暴露“资源”(如只读数据)和“工具”(如可执行操作)。开发者可以直接运行这个演示服务器,并通过兼容MCP的客户端(如Claude Desktop)与之交互,直观地看到MCP的运作流程。

它非常适合希望学习MCP协议、为AI助手开发自定义工具或资源接口的后端、全栈及智能体开发者。对于有Node.js/TypeScript基础的开发者来说,上手门槛较低。

使用建议是,将其作为学习模板或项目脚手架。你可以先运行示例,理解其结构,然后基于此修改或添加你自己的资源和工具。注意,这是一个演示项目,其代码结构清晰但功能有限,不适合直接用于生产环境,需要你在此基础上进行二次开发以满足实际需求。

核心特点

这是一个纯粹的、结构清晰的MCP服务器“教学示例”,而非功能完备的成品工具。它专注于用最少的代码演示MCP的核心概念(资源与工具),代码注释和结构设计都以教学为目的,让开发者能快速理解MCP服务器的构建模式。

注意事项

这是一个演示项目,本身不提供可直接用于生产环境的实际功能(如查询真实数据库或调用复杂API)。

常见问题

这个MCP演示工具能做什么?

它演示了如何构建一个MCP服务器,你可以通过AI客户端查询它定义的示例资源(如服务器信息)或调用示例工具(如执行简单计算)。

我需要什么基础才能使用它?

需要基本的Node.js和TypeScript知识,以及对MCP协议有初步了解。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/demo-demo-mcp-server/raw/index.md 读取 demo 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。