关键词

新闻资讯文章检索纽约时报信息查询内容服务

NYTimes Article Search MCP Server 使用说明

项目简介

本项目是一个实现了 Model Context Protocol (MCP) 的服务器，旨在通过 工具 (Tools) 的形式向 LLM 客户端提供访问纽约时报文章搜索功能。它允许用户使用关键词搜索近30天内的纽约时报文章，并将结果以结构化的 JSON 格式返回，方便 LLM 理解和利用。

主要功能点

  • 文章搜索工具: 提供 'search_articles' 工具，允许用户通过关键词搜索纽约时报文章。
  • 关键词搜索: 用户可以指定关键词来查找相关的文章。
  • 近30天文章: 搜索范围限定在最近30天发布的文章。
  • 结构化输出: 搜索结果以 JSON 格式返回，包含文章标题、摘要、URL、发布日期和作者等信息。
  • MCP 标准协议: 采用 MCP 协议与客户端通信，保证了与 MCP 客户端的兼容性。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的电脑上已经安装了 Node.js 和 npm (Node 包管理器)。
  2. 克隆仓库: 使用 git 命令克隆代码仓库到本地： 
    git clone https://github.com/MCP-Mirror/angheljf_nyt
  3. 进入项目目录: 打开终端，进入克隆下来的项目目录 'angheljf_nyt'。 
    cd angheljf_nyt
  4. 安装依赖: 运行 npm 命令安装项目所需的依赖包： 
    npm install
  5. 配置 NYTimes API 密钥:
    • 前往 纽约时报开发者网站 申请 API 密钥 (需要注册账号并创建应用)。
    • 在项目根目录下创建 '.env' 文件。
    • 将你的 API 密钥填入 '.env' 文件，格式如下： 
      NYTIMES_API_KEY=YOUR_API_KEY_HERE
  6. 构建项目: 运行 npm 命令构建项目，将 TypeScript 代码编译为 JavaScript 代码： 
    npm run build

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，你需要在客户端中配置服务器连接信息。以下是 Claude Desktop 客户端的配置示例，你需要将 'path/to/your/build/index.js' 替换为实际构建后 'index.js' 文件的路径。

{
  "mcpServers": {
    "nyt": {
      "command": "node",
      "args": ["path/to/your/build/index.js"],
      "env": {
        "NYTIMES_API_KEY": "your_api_key_here"
      }
    }
  }
}
  • 'server name': 'nyt' (服务器名称，可以自定义)
  • 'command': 'node' (启动服务器的命令，这里使用 Node.js 运行 JavaScript 文件)
  • 'args': '["path/to/your/build/index.js"]' (传递给 'node' 命令的参数，指向服务器入口文件)
  • 'env': 'NYTIMES_API_KEY': API 密钥通过环境变量传递，这里仅为占位符，实际运行时会读取 '.env' 文件中的配置。

注意: 请根据你的实际项目 'build' 目录结构，修改 'args' 中 'index.js' 的路径。

基本使用方法

  1. 启动服务器: 在项目根目录下，运行以下命令启动 MCP 服务器： 
    node build/index.js
    服务器成功启动后，会在控制台输出 'NYTimes MCP server running on stdio'。
  2. 配置 MCP 客户端: 根据 MCP 客户端 (如 Claude Desktop) 的文档，将上面提供的服务器配置信息添加到客户端的配置文件中。
  3. 使用 'search_articles' 工具: 在 MCP 客户端中，你可以调用 'search_articles' 工具，并提供 'keyword' 参数来搜索纽约时报文章。服务器会将搜索结果返回给客户端。

关键词

新闻资讯, 文章检索, 纽约时报, 信息查询, 内容服务

信息

分类

网页与API

访问项目