天气MCP服务器

气象MCP服务器

这是一个用Python实现带有模拟响应的天气工具的MCP服务器示例。它可以用作您自己的MCP服务器的支架。它包括以下功能：

• 天气工具：一种根据给定位置提供模拟天气信息的工具。
• 连接到代理生成器：允许您将MCP服务器连接到Agent Builder进行测试和调试的功能。
• 调试中 MCP检查员：允许您使用MCP检查器调试MCP服务器的功能。

开始使用天气MCP服务器模板

先决条件

要在本地开发计算机上运行MCP服务器，您需要：

• python
• (可选-如果您喜欢紫外线) 紫外线
• Python调试器扩展

准备环境

有两种方法可以为这个项目设置环境。您可以根据自己的喜好选择其中之一。

注意：在创建虚拟环境后，重新加载VSCode或终端以确保使用虚拟环境python。

方法	步骤
使用 uv 1.创建虚拟环境： uv venv 2.运行VSCode命令”Python：选择解释器“并从创建的虚拟环境中选择python 3.安装依赖项（包括开发依赖项）： uv pip install -r pyproject.toml --extra dev
使用 pip 1.创建虚拟环境： python -m venv .venv 2.运行VSCode命令”Python：选择解释器“并从创建的虚拟环境中选择python 3.安装依赖项（包括开发依赖项）： pip install -e .[dev]

设置环境后，您可以通过Agent Builder在本地开发计算机上运行服务器作为MCP客户端来开始：

1. 打开VS代码调试面板。选择 Debug in Agent Builder 或按 F5 开始调试MCP服务器。
2. 使用AI Toolkit代理生成器测试服务器 这个提示。服务器将自动连接到代理生成器。
3. 点击 Run 使用提示测试服务器。

恭喜！您已通过代理生成器作为MCP客户端在本地开发计算机上成功运行了天气MCP服务器。

模板中包含的内容

文件夹/文件	内容
.vscode	用于调试的VSCode文件
.aitk	AI工具包的配置
src	天气mcp服务器的源代码

如何调试天气MCP服务器

笔记：

• MCP检查员 是一个用于测试和调试MCP服务器的可视化开发工具。
• 所有调试模式都支持断点，因此您可以在工具实现代码中添加断点。

调试模式	说明	调试步骤
Agent Builder	通过AI Toolkit在Agent Builder中调试MCP服务器。1.打开VS代码调试面板。选择 Debug in Agent Builder 并按 F5 开始调试MCP服务器。 2.使用AI Toolkit Agent Builder对服务器进行测试 这个提示。服务器将自动连接到代理生成器。 3.点击 Run 使用提示测试服务器。
MCP检查器	使用MCP检查器调试MCP服务器。1.安装 Node.js 2.设置检查员： cd inspector && npm install 3.打开VS代码调试面板。选择 Debug in Inspector。按F5开始调试。 4.当MCP检查器在浏览器中启动时，单击 Connect 按钮连接此MCP服务器。 5.然后你可以 List Tools，选择工具，输入参数，以及 Run Tool 调试服务器代码。

默认端口和自定义

调试模式	端口	定义	自定义	注意
代理生成器	3001	tasks.json	编辑 tasks.json, __init__.py, mcp.json 更改上述端口。	无
MCP检查器	3001（服务器）；5173和3000（检查员）	tasks.json	编辑 tasks.json, __init__.py, .inspector.json 更改上述端口。	无

反馈

如果您对此模板有任何反馈或建议，请在 AI工具包GitHub存储库