New York Times

🚀 ニューヨークタイムズ記事検索 MCP サーバー

このサーバーは、キーワードを使って過去30日間のニューヨークタイムズの記事を検索できる、TypeScript ベースの MCP サーバーです。以下の方法で、核心的な MCP 概念を示しています。

• 記事を検索するためのツール
• ニューヨークタイムズ API の統合

✨ 主な機能

ツール

• 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](https://github.com/modelcontextprotocol/inspector) の使用をおすすめします。
npm run inspector

Inspector は、ブラウザでアクセスできるデバッグツールの URL を提供します。

🔧 技術詳細

環境変数

プロジェクトのルートディレクトリに .env ファイルを作成し、ニューヨークタイムズの API キーを追加します。

NYTIMES_API_KEY=your_api_key_here

サーバーの起動

プロジェクトをビルドした後、以下のコマンドでサーバーを起動できます。

node build/index.js

サーバーは起動し、標準入出力を通じた MCP リクエストを待機します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。