NYT MCP 服务器

一个消息集中协议 (MCP) 服务器，提供一个统一、简单的接口来访问纽约时报的 API。 该服务器通过单个端点简化了与多个 NYT API 的交互。

概述

此 MCP 服务器充当各种纽约时报 API 的统一网关，包括：

• 文章搜索
• 头条新闻
• Times Wire（实时新闻）
• 最受欢迎
• 档案
• 图书 API

特性

• 单个端点：通过一个一致的接口访问所有 NYT API
• 简洁的响应：格式化和简化的 API 响应
• 实时更新：通过 Times Wire 实时新闻提要
• 灵活搜索：全面的文章搜索功能
• 错误处理：强大的错误管理
• 健康监控：内置健康检查端点
• 易于集成：易于与任何应用程序集成

要求

• Python 3.8+
• NYT API 密钥（在 NYT 开发者门户 获取）
• 必需的 Python 包（参见 requirements.txt）

快速开始

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

项目结构

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

API 文档

基础 URL

http://localhost:8000

端点

POST /mcp/message

用于所有 NYT API 交互的主要端点。

GET /health

健康检查端点。

使用示例

import httpx
import asyncio

async def get_news():
    async with httpx.AsyncClient() as client:
        response = await client.post(
            "http://localhost:8000/mcp/message",
            json={
                "message_type": "times_wire",
                "content": {"limit": 5},
                "timestamp": "2025-03-05T21:00:00Z"
            }
        )
        return response.json()

# 运行异步函数
asyncio.run(get_news())

消息类型

1. 文章搜索

{
    "message_type": "article_search",
    "content": {
        "query": "technology",
        "sort": "newest",
        "page": 0
    },
    "timestamp": "2025-03-05T21:00:00Z"
}

2. 头条新闻

{
    "message_type": "top_stories",
    "content": {
        "section": "technology"
    },
    "timestamp": "2025-03-05T21:00:00Z"
}

3. Times Wire

{
    "message_type": "times_wire",
    "content": {
        "limit": 5,
        "source": "nyt"
    },
    "timestamp": "2025-03-05T21:00:00Z"
}

4. 最受欢迎

{
    "message_type": "most_popular",
    "content": {
        "type": "viewed",
        "time_period": "7"
    },
    "timestamp": "2025-03-05T21:00:00Z"
}

5. 档案

{
    "message_type": "archive",
    "content": {
        "year": 2025,
        "month": 3
    },
    "timestamp": "2025-03-05T21:00:00Z"
}

6. 图书

{
    "message_type": "books",
    "content": {
        "list": "hardcover-fiction"
    },
    "timestamp": "2025-03-05T21:00:00Z"
}

贡献

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开一个 Pull Request

许可证

MIT 许可证

安全提示

• 永远不要提交你的 .env 文件
• 保护你的 NYT API 密钥的私密性
• 对敏感数据使用环境变量

联系方式

创建 issue 以报告错误或提出功能请求。