纽约时报 MCP 服务器

一个统一的消息汇聚协议 (MCP) 服务器，提供与纽约时报（NYT）各种 API 的简单统一接口。该服务器通过单个端点简化了对多个 NYT API 的交互。

概述

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

• 文章搜索
• 热门故事
• 时报新闻（实时新闻）
• 最受欢迎的内容
• 存档
• 图书 API

功能

• 单一端点：通过一个一致的接口访问所有 NYT API
• 清晰响应：格式化和简化的 API 响应
• 实时更新：通过时报新闻获取实时新闻 feed
• 灵活搜索：全面的的文章搜索功能
• 错误处理：强大的错误管理
• 健康监测：内置健康检查端点
• 易于集成：简单易行，适用于任何应用程序

要求

• Python 3.8+
• NYT API Key（在 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

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

GET /health

消息类型

• 文章搜索：通过关键词或标题查找相关文章。
• 热门故事：获取当前最热门的故事列表。
• 时报新闻：实时更新的新闻 feed。
• 最受欢迎的内容：查看用户浏览量最高的内容。
• 存档：访问历史文章和旧闻。
• 图书 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 的私密性
• 使用环境变量存储敏感数据

联系方式

通过创建问题报告错误或提出功能请求。