Nyt MCP Server

🚀 ニューヨークタイムズ MCP サーバー

このサーバーは、統一メッセージ収束プロトコル (MCP) サーバーで、ニューヨークタイムズ (NYT) の様々な API とのシンプルで統一されたインターフェースを提供します。単一のエンドポイントを通じて、複数の NYT API とのやり取りを簡素化します。

🚀 クイックスタート

1. リポジトリをクローンします。

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

2. 仮想環境を作成してアクティブ化します。

python -m venv venv
source venv/bin/activate  # Windows システムでは：venv\Scripts\activate を使用

3. 依存関係をインストールします。

pip install -r requirements.txt

4. .env ファイルを作成します。

NYT_API_KEY=your_api_key_here
MCP_PORT=8000
MCP_HOST=0.0.0.0

5. サーバーを起動します。

python src/server.py

✨ 主な機能

• 単一エンドポイント：1 つの一貫したインターフェースを通じてすべての NYT API にアクセスできます。
• 明確なレスポンス：API レスポンスがフォーマットされ、簡素化されています。
• リアルタイム更新：タイムズニュースを通じてリアルタイムのニュースフィードを取得できます。
• 柔軟な検索：包括的な記事検索機能が備わっています。
• エラー処理：強力なエラー管理機能があります。
• ヘルスモニタリング：組み込みのヘルスチェックエンドポイントがあります。
• 簡単な統合：どんなアプリケーションにも簡単に統合できます。

📦 インストール

必要条件

• Python 3.8+
• NYT API Key（NYT 開発者ポータル で取得）
• 必要な Python パッケージ（requirements.txt を参照）

📚 ドキュメント

概要

この MCP サーバーは、複数のニューヨークタイムズ API の統一ゲートウェイとして機能します。以下の API を含みます。

• 記事検索
• 人気の記事
• タイムズニュース（リアルタイムニュース）
• 最も人気のあるコンテンツ
• アーカイブ
• 書籍 API

プロジェクト構造

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

API ドキュメント

基本 URL

http://localhost:8000

エンドポイント

POST /mcp

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

GET /health

メッセージタイプ

• 記事検索：キーワードまたはタイトルで関連する記事を検索します。
• 人気の記事：現在最も人気のある記事のリストを取得します。
• タイムズニュース：リアルタイムで更新されるニュースフィードを取得します。
• 最も人気のあるコンテンツ：ユーザーの閲覧数が最も多いコンテンツを表示します。
• アーカイブ：過去の記事や旧聞にアクセスします。
• 書籍 API：書籍情報や在庫状況を照会します。

🔧 貢献方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/AmazingFeature）。
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）。
4. ブランチにプッシュします（git push origin feature/AmazingFeature）。
5. Pull Request を開きます。

📄 ライセンス

MIT License

⚠️ 重要提示

• .env ファイルを決してコミットしないでください。
• NYT API Key を秘密に保ってください。
• 環境変数を使用して機密データを保存してください。

🔗 連絡先

問題を報告したり、機能要求を提出したりするには、イシューを作成してください。