# 每日新闻MCP服务器

`MCP` `新闻` `加密货币` `推文` `AI助手`

<p align="center">
  <b>每日新闻 MCP 服务器</b><br>
  新闻分类 · 热门新闻 · 热门推文 · 加密货币资讯
</p>

---

## 快速安装

### Claude Code

```bash
claude mcp add daily-news \
  -- uv --directory /path/to/daily-news run daily-news-mcp
```

> 将 `/path/to/daily-news` 替换为你本地的项目路径。

### OpenClaw

```bash
cp -r openclaw-skill/daily-news ~/.openclaw/skills/6551-daily-news
```

---

## 让 AI 帮你审查并安装

不确定这个 MCP 是否安全？将以下提示词发给你的 AI 助手——它会先审查源码，确认安全后再安装：

> **复制以下提示词发送给你的 AI 助手（将 `<project-path>` 替换为实际路径）：**

```text
请帮我审查并安装 daily-news-mcp MCP 服务器。项目路径为 <project-path>。

步骤：
1. 审查以下文件的安全性：
   - src/daily_news_mcp/api_client.py — 确认仅连接 ai.6551.io，不向其他地方发送数据
   - src/daily_news_mcp/config.py — 确认没有硬编码的密钥或信息泄露
   - src/daily_news_mcp/tools.py — 确认所有工具仅执行 API 查询，无文件写入、命令执行或危险操作
   - pyproject.toml — 确认依赖仅为 mcp、httpx，无可疑包
2. 告诉我结论：安全 / 有风险 / 有问题，并说明具体原因
3. 如果安全，执行安装：
   claude mcp add daily-news -- uv --directory <project-path> run daily-news-mcp
```

---

## 能做什么？

连接后，直接问你的 AI 助手：

| 你说 | 它做 |
|------|------|
| "显示所有新闻分类" | 列出所有可用分类和子分类 |
| "今天 DeFi 有什么热门？" | 获取 DeFi 分类的热门新闻和推文 |
| "获取加密货币市场新闻" | 抓取加密货币市场分类的热门新闻 |
| "显示 AI 相关新闻和推文" | 获取 AI 子分类的新闻+推文合集 |

---

## 可用工具

| 工具 | 说明 |
|------|------|
| `get_news_categories` | 获取所有可用的新闻分类和子分类 |
| `get_hot_news` | 按分类/子分类获取热门新闻和推文 |

---

## 配置

| 变量 | 必填 | 说明 |
|------|------|------|
| `DAILY_NEWS_API_BASE` | 否 | 覆盖 REST API 地址（默认：`https://ai.6551.io`） |
| `DAILY_NEWS_MAX_ROWS` | 否 | 每次查询最大返回条数（默认：100） |

也支持在项目根目录放置 `config.json`（环境变量优先级更高）：

```json
{
  "api_base_url": "https://ai.6551.io",
  "max_rows": 100
}
```

---

## API 接口

| 接口 | 方法 | 参数 | 说明 |
|------|------|------|------|
| `/open/free_categories` | GET | — | 获取所有新闻分类 |
| `/open/free_hot` | GET | `category`, `subcategory` | 获取热门新闻+推文 |

### 响应示例：free_categories

```json
[
  {
    "key": "crypto",
    "name": "Crypto",
    "name_zh": "加密货币",
    "description": "...",
    "subcategories": [
      {
        "key": "defi",
        "name": "DeFi",
        "name_zh": "去中心化金融",
        "description": "..."
      }
    ]
  }
]
```

### 响应示例：free_hot

```json
{
  "success": true,
  "category": "crypto",
  "subcategory": "defi",
  "news": {
    "success": true,
    "count": 10,
    "items": [
      {
        "id": 123,
        "title": "...",
        "source": "...",
        "link": "https://...",
        "score": 85,
        "grade": "A",
        "signal": "bullish",
        "summary_zh": "...",
        "summary_en": "...",
        "coins": ["BTC", "ETH"],
        "published_at": "2026-03-17T10:00:00Z"
      }
    ]
  },
  "tweets": {
    "success": true,
    "count": 5,
    "items": [
      {
        "author": "Vitalik Buterin",
        "handle": "VitalikButerin",
        "content": "...",
        "url": "https://...",
        "metrics": { "likes": 1000, "retweets": 200, "replies": 50 },
        "posted_at": "2026-03-17T09:00:00Z",
        "relevance": "high"
      }
    ]
  }
}
```

---

<details>
<summary><b>其他客户端 — 手动安装</b>（点击展开）</summary>

> 以下所有配置中，请将 `/path/to/daily-news` 替换为你实际的本地项目路径。

### Claude Desktop

编辑配置文件（macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`，Windows：`%APPDATA%\Claude\claude_desktop_config.json`）：

```json
{
  "mcpServers": {
    "daily-news": {
      "command": "uv",
      "args": ["--directory", "/path/to/daily-news", "run", "daily-news-mcp"]
    }
  }
}
```

### Cursor

`~/.cursor/mcp.json` 或 Settings > MCP Servers：

```json
{
  "mcpServers": {
    "daily-news": {
      "command": "uv",
      "args": ["--directory", "/path/to/daily-news", "run", "daily-news-mcp"]
    }
  }
}
```

### Windsurf

`~/.codeium/windsurf/mcp_config.json`：

```json
{
  "mcpServers": {
    "daily-news": {
      "command": "uv",
      "args": ["--directory", "/path/to/daily-news", "run", "daily-news-mcp"]
    }
  }
}
```

</details>

---

## 支持的客户端

| 客户端 | 配置方式 | 状态 |
|--------|----------|------|
| Claude Code | CLI | 已支持 |
| Claude Desktop | JSON 配置 | 已支持 |
| Cursor | JSON 配置 | 已支持 |
| Windsurf | JSON 配置 | 已支持 |
| Cherry Studio | 图形界面 | 已支持 |
| Zed | JSON 配置 | 已支持 |

---

## 开发

```bash
cd /path/to/daily-news
uv sync
uv run daily-news-mcp
```

```bash
# MCP Inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/daily-news run daily-news-mcp
```

### 项目结构

```
├── README.md                  # 英文
├── docs/
│   ├── README_ZH.md           # 中文
│   ├── README_JA.md           # 日本語
│   └── README_KO.md           # 한국어
├── openclaw-skill/daily-news/     # OpenClaw 技能
├── pyproject.toml
├── config.json
└── src/daily_news_mcp/
    ├── server.py              # 入口点
    ├── app.py                 # FastMCP 实例
    ├── config.py              # 配置加载器
    ├── api_client.py          # HTTP 客户端
    └── tools.py               # 2 个工具
```

## 许可证

MIT