Nyt MCP Server

🚀 紐約時報 MCP 服務器

本項目是一個統一的消息匯聚協議 (MCP) 服務器，它為紐約時報（NYT）的各類 API 提供了簡單統一的接口。藉助該服務器，用戶能夠通過單個端點輕鬆與多個 NYT API 進行交互，極大地簡化了操作流程。

🚀 快速開始

克隆倉庫

git clone https://github.com/your-username/nyt-mcp-server.git
cd nyt-mcp-server

創建並激活虛擬環境

python -m venv venv
source venv/bin/activate  # Windows 系統請使用：venv\Scripts\activate

安裝依賴項

pip install -r requirements.txt

創建 .env 文件

NYT_API_KEY=your_api_key_here
MCP_PORT=8000
MCP_HOST=0.0.0.0

運行服務器

python src/server.py

✨ 主要特性

• 單一端點：通過一個一致的接口訪問所有 NYT API。
• 清晰響應：格式化和簡化的 API 響應，讓數據查看更輕鬆。
• 即時更新：通過時報新聞獲取即時新聞 feed，緊跟時事動態。
• 靈活搜索：具備全面的文章搜索功能，可精準查找所需文章。
• 錯誤處理：強大的錯誤管理機制，保障系統穩定運行。
• 健康監測：內置健康檢查端點，方便隨時瞭解服務器狀態。
• 易於集成：簡單易行，適用於任何應用程序。

📦 安裝指南

環境要求

• Python 3.8+
• NYT API Key（可在 NYT 開發者門戶 獲取）
• 必要的 Python 包（見 requirements.txt）

安裝步驟

按照快速開始中的步驟依次執行克隆倉庫、創建並激活虛擬環境、安裝依賴項、創建 .env 文件和運行服務器的操作。

💻 使用示例

基礎用法

POST /mcp

{
  "operation": "search",
  "parameters": {
    "query": "example"
  }
}

GET /health

📚 詳細文檔

概述

此 MCP 服務器充當多個紐約時報 API 的統一網關，涵蓋的 API 包括：

• 文章搜索
• 熱門故事
• 時報新聞（即時新聞）
• 最受歡迎的內容
• 存檔
• 圖書 API

消息類型

• 文章搜索：通過關鍵詞或標題查找相關文章。
• 熱門故事：獲取當前最熱門的故事列表。
• 時報新聞：即時更新的新聞 feed。
• 最受歡迎的內容：查看用戶瀏覽量最高的內容。
• 存檔：訪問歷史文章和舊聞。
• 圖書 API：查詢書籍信息和庫存狀態。

項目結構

nyt-mcp-server/
├── src/
│   ├── __init__.py
│   ├── server.py
│   └── config.py
├── .env
├── .gitignore
├── requirements.txt
└── README.md

API 文檔

基礎 URL

http://localhost:8000

端點

• POST /mcp：用於執行各種操作，如文章搜索等。
• GET /health：用於檢查服務器的健康狀態。

🔧 技術細節

本項目使用 Python 3.8+ 開發，通過單個端點實現了對多個紐約時報 API 的統一訪問。它對 API 響應進行了格式化和簡化處理，同時具備強大的錯誤管理和健康監測功能。項目結構清晰，便於維護和擴展。

📄 許可證

本項目採用 MIT License。

⚠️ 重要提示

• 永遠不要提交 .env 文件，避免敏感信息洩露。
• 保持 NYT API Key 的私密性，防止他人濫用。
• 使用環境變量存儲敏感數據，增強數據安全性。

貢獻

如果你想為項目做出貢獻，可以按照以下步驟進行：

1. 叉取倉庫。
2. 創建功能分支（git checkout -b feature/AmazingFeature）。
3. 提交更改（git commit -m 'Add some AmazingFeature'）。
4. 推送到分支（git push origin feature/AmazingFeature）。
5. 打開 Pull Request。

聯繫方式

如果你發現了錯誤或有功能請求，可以通過創建問題進行反饋。