项目简介

Perigon 新闻 API MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端应用，专注于为大型语言模型 (LLM) 客户端提供对 Perigon 新闻 API 的标准化访问能力。通过集成此服务器，LLM 应用可以直接调用外部工具获取最新的新闻数据，丰富对话的上下文信息。

主要功能点

新闻数据获取工具: 注册并提供一个名为 'read_news_articles' 的工具，允许 LLM 调用以搜索和检索 Perigon 新闻 API 中的文章。
参数化查询: 支持通过工具调用传递查询关键词、日期范围（从/到）、国家及排序方式等参数，实现精确的新闻搜索。
集成外部 API: 封装了对 Perigon 新闻 API 的调用，处理请求和响应，并将结构化新闻数据返回给 LLM 客户端。
标准化接口: 遵循 MCP 标准，通过 JSON-RPC 协议与客户端通信，确保与兼容 MCP 的 LLM 客户端无缝集成。

安装步骤 (本地开发)

确保您已安装 Node.js 和 Bun（推荐）。
克隆该 GitHub 仓库。
在项目根目录运行 'bun i' 安装依赖。
运行 'bun start' 启动 MCP 服务器（默认会启动服务器和 MCP Inspector 工具）。

服务器配置 (MCP 客户端配置)

为了让您的 MCP 客户端连接到此服务器（本地运行或远程部署），您需要在客户端的 MCP 配置中添加相应的服务器条目。配置信息为 JSON 格式，通常包含在客户端应用的配置文件中（例如 '.mcp.json' 或类似文件）。以下是需要提供的关键信息及其含义：

服务器名称 (Server Name): 您为此 MCP 服务器在客户端中指定的唯一标识符，例如 'perigon_news_api'。
启动命令 (Command): 启动与服务器通信的进程命令。对于远程服务器，通常会使用 'mcp-remote' 这样的代理工具。例如，如果使用 'mcp-remote' 连接到一个 SSE 端点，命令可能是 'npx'。
命令参数 (Args): 传递给启动命令的参数列表。例如，对于 'mcp-remote'，参数可能包含服务器的 URL ('https://mcp.perigon.io/v1/sse') 和身份验证所需的头部信息 ('--header', 'Authorization: Bearer your_api_key_here')。'your_api_key_here' 需要替换为您的实际 Perigon API Key，通常通过环境变量注入更安全。
环境变量 (Env): 为启动命令进程设置的环境变量。您可以在此处设置 'PERIGON_API_KEY' 等敏感信息。

客户端将使用这些配置来启动一个子进程并与 MCP 服务器建立连接。

基本使用方法 (通过 MCP 客户端)

一旦您的 MCP 客户端配置并成功连接到 Perigon 新闻 API MCP 服务器，您的 LLM 应用就可以通过 MCP 协议调用服务器上注册的工具。

例如，LLM 可以发送一个 JSON-RPC 请求，调用 'read_news_articles' 工具并提供搜索参数（如查询字符串 'q'）。服务器将接收请求，执行工具逻辑（调用 Perigon API），然后将获取到的新闻文章数据作为工具调用的结果返回给 LLM 客户端。LLM 可以解析这些数据并在对话中利用这些新闻信息。

关键词

信息