使用说明

项目简介

本项目是一个简单的MCP服务器示例，专注于提供天气预报工具。它使用FastMCP框架构建，并通过SSE（Server-Sent Events）协议与MCP客户端通信。该服务器提供了一个 'get_forecast' 工具，允许客户端查询指定地点的天气预报。

主要功能点

• 提供天气预报工具: 实现了 'get_forecast' 工具，根据地点返回简单的天气预报信息。
• 基于MCP协议: 遵循 Model Context Protocol 标准，可以被任何兼容MCP协议的客户端调用。
• SSE传输协议: 使用 Server-Sent Events 作为 MCP 服务器的传输协议，实现实时的通信。
• 示例服务器: 作为一个独立的、可运行的服务器示例，方便开发者理解和学习 MCP 服务器的构建。

安装步骤

1. 确保已安装 Poetry。
2. 在项目根目录下，运行以下命令安装项目依赖：

   poetry install
   

服务器配置

MCP客户端需要配置以下信息以连接到天气服务器：

{
  "server_name": "weather_server",
  "transport_protocol": "sse",
  "server_url": "http://localhost:8000/sse"
}

配置参数说明:

• 'server_name': 服务器名称，例如 'weather_server'，用于客户端识别。
• 'transport_protocol': 传输协议，这里是 'sse' (Server-Sent Events)。
• 'server_url': 天气服务器的 SSE 端点 URL，默认为 'http://localhost:8000/sse'。 您可以通过设置环境变量 'WEATHER_API_PORT' 来更改端口，例如 'WEATHER_API_PORT=8080 poetry run poe weather_server' 将使用端口 8080。

基本使用方法

1. 启动天气服务器: 在项目根目录下，运行以下命令启动天气服务器：

   poetry run poe weather_server
   

   请确保您的 'WEATHER_API_PORT' 环境变量已正确设置，或者服务器将使用默认端口 (可能为 8000，请参考 'src/servers/weather.py' 中的端口配置)。

2. 配置MCP客户端: 使用兼容 MCP 协议的客户端（例如 'oai_mcp_code_agent' 项目中的客户端），配置上述服务器配置信息，指定 'server_url' 为 'http://localhost:8000/sse' (或您实际运行服务器的地址)。

3. 客户端调用工具: 客户端成功连接到服务器后，可以发现并调用 'get_forecast' 工具，并传递 'location' 参数来查询天气预报。