天气查询服务

GO-WEATHER-MCP

概述

这个项目实现了一个MCP服务器，该服务器能够根据输入的城市提供天气信息，同时还实现了一个具有相同功能的REST API。该项目是使用Go语言开发的，并且 开放天气API 作为信息来源。

MCP（模型上下文协议）服务器是一种后端应用程序，负责管理和提供人工智能模型运行和响应请求所需的上下文信息。

这段代码是为了学习Golang中的MCP服务器概念和Clean Architecture（整洁架构）而开发的。

特点/功能

MCP工具：

• 按城市获取天气（检索指定城市的当前天气。）

项目结构

└── go-weather-mcp/
    ├── cmd
    │   └── server
    ├── go.mod
    ├── go.sum
    └── internal
        ├── api
        ├── app
        ├── config
        ├── domain
        ├── infra
        └── mcp

项目索引

入门指南/开始使用

先决条件

在开始使用 go-weather-mcp 之前，请确保您的运行环境满足以下要求：

• **去（表示命令或建议）**1.21或更新版本
• 开放天气API密钥

安装

使用以下方法之一安装 go-weather-mcp：

从源代码构建：

1. 克隆 go-weather-mcp 仓库：

❯ git clone https://github.com/alvarolspeixoto/go-weather-mcp

2. 导航到项目目录：

❯ cd go-weather-mcp

3. 安装项目依赖项：

复制并粘贴.env.example文件到.env文件中，并在其中填入你的API密钥 OPENWEATHER_API_KEY 变量。

使用 go modules  

❯ go build

使用方法

使用以下命令运行 go-weather-mcp： 使用 go modules  

❯ go run ./cmd/server --mode={mode} --port={port}

• {模式}： mcp （仅用于运行MCP服务器）， http （仅限HTTP服务器）和 dual （运行两个服务器）。
• {端口} 仅在使用时才需要 http 或者 dual 模式。

为了在Claude Desktop中测试MCP服务器，您应该在您的（环境中）对其进行配置 claude_desktop_config.jsonWindows 示例：

{
  "mcpServers": {
    "weather": {
      "command": "C:\\Users\\alvar\\OneDrive\\Documentos\\dev\\go-mcp\\go-weather-mcp.exe",
      "args": [],
      "env": {
        "MODE": "mcp",
        "OPENWEATHER_API_KEY": "your-open-weather-api-key"
      }
    }
  }
}