Newsmcp With Mediastackapi

🚀 Mediastack新聞MCP服務器

這是一個FastMCP服務器，它將Mediastack新聞API以MCP（模型上下文協議）工具的形式對外提供。該服務器可作為Smithery.ai或其他任何支持MCP的代理平臺的即插即用後端。

🚀 快速開始

本服務器可將Mediastack新聞API轉換為MCP工具，為支持MCP的平臺提供新聞數據服務。你可以按照以下步驟進行安裝和配置。

✨ 主要特性

• get_latest_news：可獲取最新的新聞報道，並提供多種過濾選項。
• get_sources：列出可用的新聞來源，並具備過濾功能。

📦 安裝指南

1. 克隆此倉庫：

   git clone <repository-url>
   cd NewsMCP_with_MediastackAPI
   

2. 安裝所需的Python包：

   pip install -r requirements.txt
   

🔧 配置說明

此服務器需要Mediastack API密鑰才能正常工作。

1. 從 mediastack.com 獲取免費的API密鑰。
2. 在項目的根目錄下創建一個名為 .env 的文件。
3. 按以下格式將你的API密鑰添加到該文件中：

   MEDIASTACK_API_KEY=your_api_key_here
   

當調用工具時，服務器將自動加載此環境變量。

💻 使用示例

本地運行

要啟動MCP服務器，請運行以下命令：

python server.py

默認情況下，服務器將在 http://0.0.0.0:8080 上啟動。

可用工具

1. get_latest_news

從Mediastack獲取最新的新聞報道。 參數說明：

• keywords（可選）：用於過濾新聞的搜索詞。
• sources（可選）：新聞來源，用逗號分隔（例如："cnn,bbc"）。
• countries（可選）：國家代碼，用逗號分隔（例如："us,gb"）。
• languages（可選）：語言代碼，用逗號分隔（例如："en,fr"）。
• categories（可選）：新聞類別，用逗號分隔。
• date（可選）：特定日期或日期範圍（YYYY - MM - DD）。
• sort（可選）：排序順序（published_desc、published_asc、popularity）。
• limit（可選）：返回結果的最大數量（默認值：25，最大值：100）。
• offset（可選）：分頁偏移量。

2. get_sources

列出Mediastack上可用的新聞來源。 參數說明：

• search（可選）：用於過濾來源的搜索詞。
• sources（可選）：特定來源，用逗號分隔。
• countries（可選）：國家代碼，用逗號分隔。
• languages（可選）：語言代碼，用逗號分隔。
• categories（可選）：新聞類別，用逗號分隔。
• limit（可選）：返回結果的最大數量（默認值：25，最大值：100）。
• offset（可選）：分頁偏移量。

在Smithery.ai上部署

1. 將此倉庫推送到GitHub。
2. 將你的GitHub倉庫連接到Smithery.ai。
3. Smithery將自動檢測 smithery.yaml 配置。
4. 在Smithery的環境變量中設置你的 MEDIASTACK_API_KEY。
5. 部署並開始使用MCP工具。 如需更多信息，請訪問 Smithery.ai文檔。

📚 詳細文檔

項目結構

.
├── app.py           # MCP工具定義
├── server.py        # FastMCP服務器設置
├── requirements.txt # Python依賴項
├── smithery.yaml    # Smithery部署配置
├── Dockerfile       # 構建Docker鏡像的說明
├── LICENSE          # 項目許可證
├── .env             # （本地）環境變量
└── README.md        # 本文件

📄 許可證

本項目採用 MIT許可證 授權。