implement tools

Author: ezh0v

.github/CONTRIBUTING.md

@@ -0,0 +1,6 @@
+# Contributing Guidelines
+
+- Fork the project on GitHub.
+- Make your feature addition or bug fix in a branch. Example branches: (`feature/name`) / (`fix/name`).
+- Push your branch to GitHub.
+- Send a Pull Request. Include a description of your changes.

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,10 @@
+name: Bug report
+description: Create a bug report
+labels: ["bug"]
+body:
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,4 @@
+contact_links:
+  - name: Telegram
+    url: https://t.me/TuanKiri
+    about: For questions, feedback and support!

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,11 @@
+name: Feature request
+description: Suggest an idea for this project
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: The problem
+      description: Describe what problem you would like to see solved.
+    validations:
+      required: true

.github/SECURITY.md

@@ -0,0 +1,7 @@
+# Security Policy
+
+If you discover a security issue, please bring it to our attention right away!
+
+## Reporting a Vulnerability
+ 
+Please **DO NOT** file a public issue to report a security vulberability, instead send your report privately to **[email protected]**.

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: gomod
+    directory: /
+    schedule:
+      interval: monthly
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly

.github/workflows/go.yml

@@ -0,0 +1,23 @@
+on: [push, pull_request]
+name: Build
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        platform: [ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.platform }}
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: "go.mod"
+
+      - name: Download dependencies
+        run: go mod download
+
+      - name: Build
+        run: go build -v ./cmd/weather-mcp-server

.gitignore

@@ -0,0 +1 @@
+vendor

README.md

@@ -0,0 +1,80 @@
+<div align="center">
+<img alt="example output template" src="./assets/weather.svg">
+
+<h1>Weather API MCP Server</h1>
+
+[![license](https://img.shields.io/badge/license-MIT-red.svg)](LICENSE)
+[![go version](https://img.shields.io/github/go-mod/go-version/TuanKiri/weather-mcp-server)](go.mod)
+[![go report](https://goreportcard.com/badge/github.com/TuanKiri/weather-mcp-server)](https://goreportcard.com/report/github.com/TuanKiri/weather-mcp-server)
+
+<strong>[Report Bug](https://github.com/TuanKiri/weather-mcp-server/issues/new?assignees=&labels=bug&projects=&template=bug_report.yml)</strong> | <strong>[Request Feature](https://github.com/TuanKiri/weather-mcp-server/issues/new?assignees=&labels=enhancement&projects=&template=feature_request.yml)</strong>
+
+</div>
+
+A lightweight Model Context Protocol (MCP) server that enables AI assistants like Claude to retrieve and interpret real-time weather data.
+
+<div align="center">
+<img alt="demo example" src="./assets/weather.gif" width="480">
+</div>
+
+## Installing on Claude Desktop
+
+To use your MCP server with Claude Desktop, add it to your Claude configuration:
+
+```json
+{
+  "mcpServers": {
+    "weather-mcp-server": {
+      "command": "/path/to/weather-mcp-server",
+      "args": [],
+      "env": {
+        "WEATHER_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+You can get your API key in your personal account at [weatherapi](https://www.weatherapi.com/my/).
+
+## Build from source
+
+You can use `go` to build the binary in the `cmd/github-mcp-server` directory.
+
+```shell
+go build -o weather-mcp-server ./cmd/weather-mcp-server
+```
+
+## Tools
+
+- **current_weather** - Gets the current weather for a city
+
+  - `city`: The name of the city (string, required)
+
+## Project Structure
+
+The project is organized into several key directories:
+
+```shell
+├── cmd
+│   └── weather-mcp-server
+├── internal
+│   └── server
+│       ├── handlers # MCP handlers
+│       ├── services # Business logic layer
+│       │   ├── core # Core application logic
+│       │   └── mock # Mock services for testing
+│       ├── tools # MCP tools
+│       └── view # Templates for displaying messages
+└── pkg
+```
+
+## Contributing
+
+Feel free to open tickets or send pull requests with improvements. Thanks in advance for your help!
+
+Please follow the [contribution guidelines](.github/CONTRIBUTING.md).
+
+## License
+
+This MCP server is licensed under the MIT License.