New York Times

🚀 紐約時報文章搜索 MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，可依據關鍵詞搜索過去 30 天內的《紐約時報》文章。它藉助搜索文章的工具，集成《紐約時報》API，生動展示了核心 MCP 概念。

✨ 主要特性

工具

• search_articles：可根據關鍵詞搜索過去 30 天內的《紐約時報》文章。
  • 需傳入 keyword 作為必需參數。
  • 返回的文章列表包含標題、摘要、URL、發佈日期和作者等信息。

📦 安裝指南

通過 Smithery 安裝

若要通過 Smithery 自動安裝《紐約時報》文章搜索以供 Claude Desktop 使用，可執行以下命令：

npx -y @smithery/cli install nyt --client claude

手動安裝

若要與 Claude Desktop 一起使用，需添加服務器配置：

• 在 MacOS 上：配置文件路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json

配置內容如下：

{
  "mcpServers": {
    "nyt": {
      "command": "node",
      "args": ["path/to/your/build/index.js"],
      "env": {
        "NYTIMES_API_KEY": "your_api_key_here"
      }
    }
  }
}

💻 使用示例

基礎用法

# 安裝依賴
npm install
# 構建服務器
npm run build
# 帶有自動重建功能的開發
npm run watch

高級用法

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們建議使用 MCP Inspector，它是作為包腳本提供的：

npm run inspector

Inspector 將提供一個可在瀏覽器中訪問調試工具的 URL。

🔧 技術細節

環境變量

需在項目根目錄中創建一個 .env 文件，並添加您的《紐約時報》API 密鑰：

NYTIMES_API_KEY=your_api_key_here

運行服務器

在構建項目後，可使用以下命令運行服務器：

node build/index.js

服務器將啟動並監聽通過標準輸入輸出的 MCP 請求。

📄 許可證

此項目根據 MIT 許可證發佈。