手把手教你用MCP输出Hello World，再到打造实用AI助手

网址

Caption

type

date

slug

summary

MCP是什么？

在讲解具体步骤前，让我们先理解MCP的本质：它是一种让AI模型能够调用外部工具、访问外部资源的协议。简单来说，MCP让Claude具备了"看得见、摸得着"外部世界的能力，之前我已经写过详细介绍，感兴趣可以先看这篇。

MCP提供三种核心功能：

工具调用：执行自定义函数（需经用户批准）

资源访问：读取外部数据、文件或API响应

提示模板：使用预设模板简化特定任务

下面，我们将通过两个案例，逐步展示MCP的强大功能。

案例一：Hello World - MCP入门

作为编程世界的传统，我们首先实现一个简单的"Hello World"示例，通过MCP让Claude能够生成简单的问候语。

第一步：环境准备

安装Python：确保系统中安装了Python 3.10或更高版本

安装Claude Desktop：从官方网站下载并安装最新版本

如果下载比较慢，可以直接从这个网盘获取：https://pan.quark.cn/s/ece1d82b7d82

安装uv工具：在PowerShell中执行

执行后请重启PowerShell，确保命令生效

第二步：创建Hello World项目

初始化项目：

创建服务器代码：新建一个hello.py文件，添加以下内容：

第三步：配置Claude Desktop

创建/编辑配置文件： Windows下，打开或创建以下位置的配置文件：

添加服务器配置：

⚠️ 注意：Windows路径中使用正斜杠(/)或双反斜杠(\\)，避免JSON解析错误

第四步：测试你的Hello World

重启Claude Desktop：确保配置生效

与Claude对话：尝试发送以下消息

"能否给我打个招呼？"

"请告诉我现在几点了？"

观察结果：Claude应识别你的意图并提示使用相应工具

当一切顺利时，你会看到Claude Desktop界面上出现一个锤子图标，点击后可以查看可用的工具。当你请求相关功能时，Claude会提示使用工具，并展示工具返回的结果。

恭喜你！你已经成功实现了第一个MCP集成。虽然这个Hello World示例非常简单，但它展示了MCP的核心工作原理。接下来，让我们创建一个更实用的服务。

案例二：天气助手 - 实用工具开发

在掌握了基础后，我们来创建一个实用的天气查询助手，让Claude能够获取实时天气信息。

第一步：创建天气服务项目

初始化项目：

创建服务器代码：新建weather.py文件，添加以下内容：

第二步：更新Claude Desktop配置

修改配置文件，添加天气服务器：

第三步：测试天气服务

重启Claude Desktop

进行天气查询：尝试问"旧金山的天气怎么样？"

观察结果：Claude应提示使用天气工具，并展示查询结果

注意：本例使用的是美国国家气象服务API，仅支持美国地区。其他国家可以替换为其他天气API。

多服务器兼容与故障排除

如何同时使用多个MCP服务

当你同时配置了多个MCP服务器时，Claude会根据你的问题智能选择合适的工具。为了帮助Claude正确选择，你可以：

使用明确的提示：明确指定要使用的工具，如"请使用hello工具向我打招呼"

确保工具描述清晰：在代码中提供详细的工具描述和文档

提高工具名称的区分度：不同服务器的工具名称应当足够区分

常见问题

执行策略限制：遇到PowerShell执行限制时，使用以下命令临时解除：

JSON配置错误：

确保所有反斜杠正确转义

检查JSON语法，特别是逗号和引号

使用在线JSON验证工具检查

服务器连接问题：

手动运行服务器测试

检查uv是否正确安装

确认路径配置正确

工具未显示：

完全重启Claude Desktop

检查锤子图标是否出现

查看Claude Desktop日志

扩展与高阶玩法

掌握了这两个基本示例后，你可以进一步扩展MCP功能：

个人知识库：创建一个连接到你的笔记或文档的服务

数据分析：构建一个能分析CSV文件的工具

智能家居控制：通过API连接到你的智能家居设备

易安总结

前天Claude刚刚宣布可以联网，但是仅仅针对美国地区，今天你就可以直接借助MCP实现联网功能。

MCP技术为AI助手开辟了全新的可能性，让其不再仅限于训练数据，而是能够与实时世界交互。虽然目前设置过程需要一些技术知识，但随着技术发展，我们可以期待更简单的配置方式和更丰富的插件生态。

通过本文的两个示例，你已经掌握了MCP的基础知识。从这里出发，你可以根据自己的需求，为Claude Desktop添加各种强大功能，真正打造一个个性化的AI助手。

未来，我将继续分享更多MCP应用案例和进阶技巧。敬请关注，一起探索AI的无限可能！