气象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客户端来开始：
- 打开VS代码调试面板。选择
Debug in Agent Builder或按F5开始调试MCP服务器。 - 使用AI Toolkit代理生成器测试服务器 这个提示。服务器将自动连接到代理生成器。
- 点击
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.安装 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 更改上述端口。 | 无 |
反馈
如果您对此模板有任何反馈或建议，请在