# Life Assistant MCP Server（生活助手小工具箱）

一个基于 HelloAgents 框架的 MCP 服务器，把 **天气查询 + 热搜新闻 + 文本处理** 三种能力打包成一个小工具箱。
全部使用免密钥的公共 API，代码只有 96 行，简单不复杂。

## 功能特性

- 🌤️ **天气查询**：支持 12 个中国主要城市实时天气（wttr.in，免密钥）
- 🔥 **热搜新闻**：头条热榜 / 百度热搜 TOP10
- 🔍 **新闻搜索**：按关键词搜索最新新闻（Bing News RSS，免密钥）
- ✂️ **文本工具**：反转、统计单词数、转大写、转小写

## 安装

```bash
pip install hello-agents requests
```

## 使用方法

### 直接运行（HTTP 传输，默认 8081 端口）

```bash
python server.py
```

### stdio 传输（Claude Desktop / HelloAgents 本地使用）

```bash
python server.py --stdio
```

### 在 Claude Desktop 中使用

编辑 `claude_desktop_config.json`：

```json
{
  "mcpServers": {
    "life-assistant": {
      "command": "python",
      "args": ["/path/to/server.py", "--stdio"]
    }
  }
}
```

### 在 HelloAgents 中使用

```python
from hello_agents import SimpleAgent, HelloAgentsLLM
from hello_agents.tools import MCPTool

agent = SimpleAgent(name="生活助手", llm=HelloAgentsLLM())
tool = MCPTool(server_command=["python", "server.py", "--stdio"])
agent.add_tool(tool)

response = agent.run("北京今天天气怎么样？顺便看看今天有什么热搜")
```

### 运行演示脚本

仓库自带一个完整演示（SimpleAgent + 工具箱：查天气 → 看热搜 → 反转文本）：

```bash
python examples/demo_agent.py
```

## API 工具

| 工具 | 说明 | 参数 |
|---|---|---|
| `get_weather` | 获取城市实时天气 | `city`(string) |
| `list_supported_cities` | 列出天气支持的城市 | 无 |
| `get_hot_news` | 热搜 TOP10 | `source` = `toutiao`(默认) / `baidu` |
| `search_news` | 按关键词搜新闻 | `keyword`(string) |
| `reverse_text` | 反转文本 | `text` |
| `count_words` | 统计单词数 | `text` |
| `to_uppercase` / `to_lowercase` | 大小写转换 | `text` |
| `get_server_info` | 服务器信息 | 无 |

### 示例

**get_weather**
```json
{"city": "北京", "temperature": 23.0, "condition": "Patchy rain nearby", "humidity": "85", "wind_kmh": 1.1, "timestamp": "2026-08-18 09:58:21"}
```

**get_hot_news**
```json
[{"rank": 1, "title": "天安门下半旗悼念朱镕基同志", "heat": "9733617"}, ...]
```

**search_news**
```json
[{"title": "从DeepSeek到"人工智能+"：中美AI竞赛究竟在比什么？", "url": "https://...", "date": "Sun, 02 Aug 2026"}, ...]
```

## 数据源（全部免密钥）

- 天气：https://wttr.in
- 热搜：https://www.toutiao.com/hot-event/hot-board 、 https://top.baidu.com
- 新闻：https://www.bing.com/news

## 支持的城市

北京、上海、广州、深圳、杭州、成都、重庆、武汉、西安、南京、天津、苏州

也支持英文城市名查询全球任意城市。

## 许可证

MIT License