🚀 纽约时报文章搜索 MCP 服务器
这是一个基于 TypeScript 的 MCP 服务器，可根据关键词搜索过去 30 天内的《纽约时报》文章。它通过集成《纽约时报》API 这一工具，充分展示了核心 MCP 概念。
🚀 快速开始
本项目是一个强大的工具，能够助力用户高效搜索过去 30 天内的《纽约时报》文章。下面为你介绍它的使用步骤。
✨ 主要特性
工具
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"
}
}
}
}
环境变量设置
在项目根目录中创建一个 .env 文件，并添加您的《纽约时报》API 密钥：
NYTIMES_API_KEY=your_api_key_here
💻 使用示例
基础用法
以下是使用 search_articles 工具的示例：
# 假设已正确安装和配置项目
# 这里只是示意使用 search_articles 工具，实际调用可能需要结合具体代码逻辑
🔧 技术细节
本项目是基于 TypeScript 构建的 MCP 服务器，通过集成《纽约时报》API 实现文章搜索功能。在开发过程中，使用了标准的 Node.js 开发流程，包括依赖安装、项目构建等操作。由于 MCP 服务器通过标准输入输出进行通信，调试时可能存在一定挑战，可借助 MCP Inspector 进行调试。
📚 详细文档
开发
安装依赖
npm install
构建服务器
npm run build
带有自动重建功能的开发
npm run watch
调试
由于 MCP 服务器通过标准输入输出进行通信，调试可能具有挑战性。我们建议使用 MCP Inspector，它是作为包脚本提供的：
npm run inspector
Inspector 将提供一个可在浏览器中访问调试工具的 URL。
运行服务器
在构建项目后，可以使用以下命令运行服务器：
node build/index.js
服务器将启动并监听通过标准输入输出的 MCP 请求。
📄 许可证
此项目根据 MIT 许可证发布。