News MCP

🚀 新聞MCP服務器

這是一個智能新聞搜索MCP（模型上下文協議）服務器，具備自動API切換功能，可實現可靠的新聞獲取。從此無需再擔心API使用限制！

🚀 快速開始

1. 安裝

# 克隆倉庫
git clone https://github.com/guangxiangdebizi/news-mcp.git
cd news-mcp

# 安裝依賴
npm install

# 複製環境模板
cp .env.example .env

2. API配置

從以下任意服務獲取免費API密鑰（只需一個，但多個密鑰可提高可靠性）：

*免費套餐聲稱無限制

3. 配置環境

編輯 .env 文件並添加你的API密鑰：

# 至少添加一個API密鑰（多個密鑰可提高可靠性）
THE_NEWS_API_KEY=your_api_key_here
NEWSDATA_IO_KEY=your_api_key_here
NEWSAPI_ORG_KEY=your_api_key_here
GNEWS_API_KEY=your_api_key_here
TWINGLY_API_KEY=your_api_key_here

4. 構建並運行

# 構建項目
npm run build

# 啟動MCP服務器
npm start

# 或者以開發模式運行
npm run dev

✨ 主要特性

• 🔄 智能API切換：當某個新聞API達到使用限制時，自動在多個新聞API之間切換。
• 🆓 多個免費API：支持5個以上免費新聞API，每日配額充足。
• 📊 配額管理：智能跟蹤每日API使用限制。
• 🌍 多語言支持：支持20多種語言的新聞搜索。
• ⚡ 快速可靠：故障轉移機制確保始終能獲取結果。
• 🛠️ 易於設置：通過環境變量進行簡單配置。

💻 使用示例

基礎用法

與Claude Desktop配合使用

添加到Claude Desktop配置中：

標準輸入輸出模式（本地開發）：

{
  "mcpServers": {
    "news-mcp": {
      "command": "node",
      "args": ["path/to/news-mcp/build/index.js"]
    }
  }
}

服務器發送事件（SSE）模式（Web訪問）：

# 啟動SSE服務器
npm run sse

{
  "mcpServers": {
    "news-mcp": {
      "type": "sse",
      "url": "http://localhost:3100/sse",
      "timeout": 600
    }
  }
}

可用工具

search_news

使用自動API切換功能搜索新聞文章。

參數：

• query（必需）：搜索關鍵詞或主題。
• language（可選）：語言代碼（默認："en"）。
• limit（可選）：文章數量（1 - 10，默認：5）。

示例：

// 搜索科技新聞
{
  "query": "artificial intelligence",
  "language": "en",
  "limit": 5
}

// 搜索中文新聞
{
  "query": "科技新聞",
  "language": "zh",
  "limit": 3
}

🔧 技術細節

智能切換的工作原理

1. 優先級順序：按可靠性和配額限制順序嘗試API。
2. 配額跟蹤：系統跟蹤每個API的每日使用情況。
3. 自動故障轉移：當某個API失敗或達到限制時，自動嘗試下一個API。
4. 成功保證：持續嘗試，直到獲得成功響應或所有API都已耗盡。

TheNewsAPI (∞) → NewsData.io (200) → NewsAPI.org (100) → GNews (100) → Twingly (50)

支持的語言

• 英語（en） - 所有API支持
• 中文（zh） - 大多數API支持
• 西班牙語（es） - 大多數API支持
• 法語（fr） - 大多數API支持
• 德語（de） - 大多數API支持
• 以及15種以上其他語言

🛠️ 開發

項目結構

src/
├── index.ts              # MCP服務器入口點
├── config.ts             # API配置管理
└── tools/
    └── newsSearch.ts     # 智能新聞搜索工具

腳本

npm run build     # 構建TypeScript項目
npm run dev       # 開發模式，即時監聽文件變化
npm start         # 啟動已構建的服務器
npm run sse       # 在端口3100上啟動SSE服務器

添加新API

1. 在 src/config.ts 中添加API配置。
2. 在 src/tools/newsSearch.ts 中實現特定於API的請求邏輯。
3. 在 .env.example 中添加環境變量。

🤝 貢獻

歡迎貢獻代碼！請隨時提交拉取請求。

1. 分叉倉庫。
2. 創建你的功能分支 (git checkout -b feature/AmazingFeature)。
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')。
4. 推送到該分支 (git push origin feature/AmazingFeature)。
5. 打開拉取請求。

📄 許可證

本項目採用Apache License 2.0許可 - 詳情請參閱 LICENSE 文件。

👨‍💻 作者

陳星宇

• 🌐 網站：GitHub個人資料
• 📧 郵箱：guangxiangdebizi@gmail.com
• 💼 LinkedIn：陳星宇
• 📦 NPM：@xingyuchen

🙏 致謝

• 模型上下文協議 提供了出色的MCP框架。
• 所有新聞API提供商提供了慷慨的免費套餐。
• 開源社區提供了靈感和支持。

⭐ 如果這個項目對你有幫助，請給它點個星！