> ## Documentation Index
> Fetch the complete documentation index at: https://labs.prompthon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Weather MCP Server 入门项目

<div className="not-prose my-4 rounded-md border border-gray-200 bg-gray-50 p-2 text-sm dark:border-gray-800 dark:bg-gray-900/40">
  <div className="mb-2 px-1 text-xs font-semibold uppercase tracking-wide text-gray-500 dark:text-gray-400">需要帮助？</div>

  <div className="flex flex-wrap gap-2">
    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://discord.gg/sDE2HhGTg4" target="_blank" rel="noreferrer">
      <Icon icon="discord" iconType="brands" size={14} />

      <span>在 Discord 提问</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/issues/new/choose" target="_blank" rel="noreferrer">
      <Icon icon="github" iconType="brands" size={14} />

      <span>提交 GitHub Issue</span>
    </a>

    <a className="inline-flex items-center gap-2 rounded-md border border-gray-200 bg-white px-3 py-1.5 font-medium text-gray-700 no-underline shadow-sm hover:border-gray-300 hover:bg-gray-50 dark:border-gray-800 dark:bg-gray-950/60 dark:text-gray-200 dark:hover:bg-gray-900" href="https://github.com/Prompthon-IO/agent-systems-handbook/blob/main/zh-Hans/SUPPORT.md" target="_blank" rel="noreferrer">
      <Icon icon="life-ring" size={14} />

      <span>支持指南</span>
    </a>
  </div>
</div>

## 概要

这个 starter 勾勒了一个面向协议的工具服务，为智能体使用提供一个小而稳定的天气接口。

## 状态

`starter`

源代码：[systems/examples/weather-mcp-server-starter](https://github.com/Prompthon-IO/agent-systems-handbook/tree/main/systems/examples/weather-mcp-server-starter)

## 存在原因

当协议示例聚焦于单个工具边界时，会更容易理解。这个 starter 将范围限制在请求校验、可预测的工具形态和响应封装上。

## 相关实验室页面

* [Protocols And Interoperability](/zh-Hans/systems/protocols-and-interoperability)
* [Systems Overview](/zh-Hans/systems)

## 文件夹结构

```text theme={null}
weather-mcp-server-starter/
├── index.mdx
└── src/
    ├── access_policy.py
    ├── server.py
    └── tool_manifest.py
```

## 快速开始

这是一个 starter，不是一个完成的服务器。示例文件展示了接口形态和处理器边界，但没有引入完整的协议运行时。要做仓库级别的冒烟检查，请在仓库根目录运行 `python3 scripts/verify_example_projects.py`。

## 包含的示例文件

* `src/server.py`：单个工具的最小请求与响应边界
* `src/tool_manifest.py`：一个简洁示例，说明面向协议的 starter
  如何声明其输入模式和输出形态
* `src/access_policy.py`：一个小型授权边界，将权限检查与工具处理器本身分离

## 约束

* 未实现传输层。
* 不包含真实的天气 API 集成。
* 认证和权限规则仍然是占位符。

## 下一步

* 添加具体的传输层接口。
* 添加权限检查和请求日志记录。