# ai-trends MCP サーバー

「いま話題の AI トレンド」を取得して返す、デモ用の **MCP（Model Context Protocol）サーバー**です。
YouTube 技術解説動画「MCP = AI が外部ツールを使えるようにする仕組み」のデモ題材として作成しました。

AI モデル単体ではリアルタイムの最新情報を知りませんが、この Tool を通じて
外部の公開ニュースソースから直近の話題を取得できます。

## 提供する Tool

| Tool | 説明 | 引数 |
|---|---|---|
| `get_ai_trends` | いま話題の AI 関連トレンドを取得 | `query`（既定 `"AI"`）, `limit`（既定 `5`, 最大 `10`） |

- 主データソース: Google ニュース RSS（日本語）
- 予備データソース: Hacker News (Algolia API) — 主ソースが落ちても止まらない二重化
- 依存は MCP SDK のみ。HTTP 取得・RSS/JSON パースは Python 標準ライブラリで完結。

## セットアップ

```powershell
# 1. 仮想環境を作成
python -m venv .venv

# 2. MCP SDK をインストール
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
```

## 動作確認

```powershell
# トレンド取得ロジックの直接テスト
.\.venv\Scripts\python.exe test_server.py

# MCP プロトコル経由のスモークテスト（Cline と同じ経路）
.\.venv\Scripts\python.exe test_mcp_client.py
```

## Cline への登録

`cline_mcp_settings.json` に以下を追記します

```json
{
  "mcpServers": {
    "ai-trends": {
      "command": "C:\\Users\\thatb\\OneDrive\\デスクトップ\\workspace\\mcp-ai-trends\\.venv\\Scripts\\python.exe",
      "args": ["C:\\Users\\thatb\\OneDrive\\デスクトップ\\workspace\\mcp-ai-trends\\server.py"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

登録後、Cline に「最新の AI トレンドを教えて」と聞くと、Cline が `get_ai_trends` の
使用許可を求め、承認すると実際のトレンドが返ってきます。

## ファイル構成

```
mcp-ai-trends/
├─ server.py              … MCP サーバー本体
├─ test_server.py         … 取得ロジックの直接テスト
├─ test_mcp_client.py     … MCP プロトコル経由のスモークテスト
├─ requirements.txt       … 依存（mcp のみ）
├─ README_git.md              … このファイル
└─ 
```