Valuable insights
1.MCP服务器简化AI与API交互: MCP服务器通过提供工具箱,使AI能够自主选择并使用API,从而避免了传统编程中对AI进行微观管理的复杂性,极大地简化了AI与外部服务的集成。
2.MCP服务器的核心组成与能力: MCP服务器包含工具(AI可调用的函数)、资源(AI可读取的文件数据)和提示(预设任务模板)三大能力,这些共同构成了AI与外部世界交互的基础。
3.构建MCP服务器的关键步骤: 构建MCP服务器涉及项目初始化、依赖安装、配置`package.json`和`tsconfig.json`,以及在`index.ts`中定义服务器实例、辅助函数和`server.tool`方法,从而实现AI能力的扩展。
4.Claude AI与MCP服务器的集成: 通过在Claude桌面应用中配置开发者模式,并指定MCP服务器构建后的JavaScript文件路径,可以将自定义的MCP工具集成到Claude AI中,使其能够调用这些工具。
5.MCP服务器的实际应用价值: 通过构建一个天气预报MCP服务器的实时演示,展示了MCP如何赋能Claude AI,使其能够自主地获取并处理实时外部数据,如当前温度,极大地增强了AI的实用性。
引言
本指南旨在引导您在不到五分钟的时间内,共同构建您的第一个MCP服务器。MCP,即“模型能力平台”,正在AI领域引发广泛讨论。本文将深入探讨MCP的定义、工作原理,并手把手教您搭建一个功能完备的MCP服务器,助您快速掌握这项前沿技术。
什么是MCP以及为何它很重要
传统上,当需要AI与外部API进行交互时,开发者必须极其精确地编写指令。这就像拥有一位技术娴熟的机械师,却被迫事无巨细地指挥他们每一个动作,例如“现在使用10毫米扳手,不,不是那样,是这样。现在放下它,拿起套筒扳手。”开发者需要为每一种可能的情景硬编码明确的指令,比如“如果用户询问天气,则调用此端点并附带这些参数。”在这种模式下,AI没有自主权,所有逻辑都是硬编码的,任何可能的路径都需要大量的编程工作。
“把MCP想象成给一位熟练的机械师一个组织良好的专用工具箱,让他们为每项工作选择合适的工具。您只需提供工具,让他们运用专业知识。”
MCP的出现彻底改变了这种局面。它允许AI像经验丰富的专业人士一样,根据手头的任务自主选择和使用工具。MCP服务器扮演着“工具箱”的角色,定义了哪些工具可供AI使用。服务器会告知Claude:“这是您可以访问的工具,”而无需预设何时或如何精确使用这些工具。Claude随后可以根据对话内容,自主选择合适的工具,就像一位优秀的机械师知道该选择哪种工具一样。
MCP服务器的三种核心能力
MCP服务器为AI模型提供了三种核心能力,这些能力使得AI能够更高效、更智能地与外部环境交互。
- 工具:这些是代理可以调用的函数,例如天气API,用于执行特定的操作或获取数据。
- 资源:这是代理可以读取的文件式数据,可以为AI提供额外的信息或上下文。
- 提示:这些是针对特定任务预先编写的模板,用于指导AI生成特定格式或内容的响应。
MCP如何与Claude AI协同工作
为了更好地理解MCP服务器的运作方式,我们将审视其简化结构,并展示各个部分如何协同工作,共同赋能Claude AI。MCP服务器的设计旨在提供一个清晰、模块化的框架,让AI能够有效地利用其所能访问的各种能力。
MCP服务器的内部结构
MCP服务器的结构由几个关键组件构成,每个组件都扮演着不可或缺的角色,确保AI能够顺利地调用外部功能。
- 辅助函数:这些是实际调用API并根据Claude的使用需求格式化数据的地方。它们是服务器与外部服务交互的桥梁。
- 服务器实例:在这里定义服务器的元数据,包括其能力、资源和可用的工具。这是服务器的“身份证”和“能力清单”。
- `server.tool`方法:所有魔法发生的地方。该方法定义了Claude可以使用的具体工具、如何调用它们以及它们接受哪些参数。每个工具都像机械师工具箱中一个专门的仪器。
项目设置和要求
在深入编写代码之前,我们需要确保具备一些必要的先决条件和项目设置。这些准备工作是成功构建和运行MCP服务器的基础,确保开发环境能够支持所需的技术栈。
- 下载Claude Desktop App。
- 选择您偏好的集成开发环境(IDE),例如Cursor、VS Code或WebStorm等任何支持JavaScript的编辑器。
- 安装Node.js和TypeScript。
初始化项目与安装依赖
首先,在终端中创建项目目录并进入。例如,键入`mkdir weather`,然后`cd weather`。接着,使用`npm init`命令初始化项目,并安装所有必要的依赖项。请放心,所有这些命令和代码片段都将在描述中提供,方便您查阅和使用。
创建源代码文件结构
接下来,我们将创建项目的源代码目录和主文件。在项目根目录中,执行`mkdir source`,然后`cd source`,最后使用`touch index.ts`命令创建`index.ts`文件。完成这些步骤后,我们就可以在IDE中打开项目,开始编写代码了。
编写您的第一个MCP服务器(代码演练)
现在我们已经完成了项目设置,是时候深入到代码层面,编写我们的第一个MCP服务器了。我们将逐步介绍如何配置项目文件、定义服务器实例、添加辅助函数以及关键的`server.tool`方法,让您清楚地了解每个部分的作用。
配置`package.json`
首先,打开您的`package.json`文件,并将其中的脚本部分替换为以下内容。我们需要添加`
Useful links
These links were generated based on the content of the video to help you deepen your knowledge about the topics discussed.