四边形-MCP-服务器

<p align="center"> <img src="https://gips0.baidu.com/it/u=718663990,4195052306&fm=3081&app=3081&f=JPEG?w=200&h=200" width="120" alt="Perigon logo" /> </p> <h1 align="center">Perigon MCP 服务器</h1>

这是 Perigon 新闻API 的官方MCP服务器。

文档

有关如何使用和连接MCP的更多信息，请访问MCP文档。

使用方法

演示环境

您可以在我们的演示环境中尝试Perigon MCP服务器。

注意： 使用MCP需要有效的Perigon API密钥。MCP演示环境要求您已经登录到Perigon仪表板。

连接

您可以使用本地或远程MCP客户端连接到我们的远程MCP服务器。

服务器URL: https://mcp.perigon.io

支持的连接类型：

• HTTP（可流式传输）: https://mcp.perigon.io/v1/mcp
• 服务器发送事件（SSE）: https://mcp.perigon.io/v1/sse

快速设置示例

对于MCP客户端（SSE与mcp-remote）：

{
  "mcpServers": {
    "perigon_news_api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.perigon.io/v1/sse",
        "--header",
        "Authorization: Bearer ${PERIGON_API_KEY}"
      ],
      "env": {
        "PERIGON_API_KEY": "YOUR_PERIGON_API_KEY"
      }
    }
  }
}

对于支持SSE的MCP客户端：

{
  "mcpServers": {
    "perigon_news_api": {
      "url": "https://mcp.perigon.io/v1/sse",
      "type": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

对于支持HTTP（可流式传输）的客户端：

{
  "mcpServers": {
    "perigon_news_api": {
      "url": "https://mcp.perigon.io/v1/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_PERIGON_API_KEY"
      }
    }
  }
}

对于Claude Code（CLI）：

claude mcp add --transport sse perigon_news_api https://mcp.perigon.io/v1/sse \
  --header "Authorization: Bearer YOUR_PERIGON_API_KEY"

📖 关于不同客户端的详细设置说明，请参阅我们的全面MCP文档。

Smithery部署

此MCP服务器可以使用包含的Docker配置轻松部署到Smithery。该仓库包括：

• Dockerfile - 容器构建配置
• smithery.yaml - Smithery部署配置
• server.js - MCP的HTTP服务器封装

配置选项：

• apiKey（必需）：您的Perigon API密钥
• rateLimitBypass（可选）：在容器化环境中绕过速率限制（默认值：true）

MCP端点将在/mcp可用，并自动处理Smithery的查询参数配置格式。

提示示例

当提示您的代理时，我们建议提供当前日期（或获取它的工具），除非代理已经能够访问此类信息。这是因为某些模型如Claude会认为当前日期是它们的知识截止日期，并且会频繁检索过时的信息。

新闻文章与故事：

• 给我美国今天前五的政治头条。
• 今天纽约有哪些商业故事在流行？
• 显示本周加州最新的科技新闻。
• 查找过去三天内摇摆州的政治新闻。
• 显示过去一周与加密货币相关的新闻故事。

记者与来源：

• 查找德克萨斯州的地方新闻来源。
• 谁是主要出版物中的顶级商业记者？
• 查找报道可再生能源的记者，然后显示他们的最近文章。
• 哪些记者最常写关于气候政策的文章？
• 显示今天来自主要金融出版物的文章。

人物与公司：

• 查找有关制药公司CEO的最新新闻。
• 将特斯拉作为一家公司进行搜索，然后查找有关他们的近期新闻故事。
• 显示电动汽车行业的公司。
• 在医疗保健故事中搜索提到的政治家。
• 科技公司在谈论AI监管方面说了什么？

支持的工具

工具	描述
search_news_articles	通过关键词、地点、时间范围、来源和记者进行高级过滤来搜索单个新闻文章。返回全文内容或带有元数据的摘要。
search_news_stories	搜索聚类的新闻故事和标题。返回故事摘要、情感分析和元数据，以了解多个来源的重大新闻事件和趋势。
search_journalists	根据姓名、出版物、地点或覆盖区域查找记者和记者。返回记者简介，包括他们的顶级来源、地点和每月发布活动。
search_sources	根据名称、域名、地点或受众规模发现新闻出版物和媒体机构。返回源详情，包括每月访问量、顶级主题和地理重点。
search_people	搜索公众人物、政治家、名人和新闻人物。返回传记信息，包括职业、职位和详细描述。
search_companies	根据名称、域名或行业查找公司。返回公司简介，包括CEO信息、员工数量、行业分类和业务描述。
search_topics	通过Perigon API搜索当前支持的主题，以发现可用的新闻类别和主题。
search_wikipedia	搜索维基百科页面以获取任何主题的信息。返回页面摘要、内容、类别和元数据，支持通过Wikidata实体、类别和页面视图进行高级过滤。
search_vector_wikipedia	使用语义向量搜索维基百科页面，以获得更具有上下文和意义的结果。返回页面摘要、内容、类别和元数据。

问题 / 贡献

问题

此MCP服务器仍在开发中，因为我们正在确定用户希望解决的用例。但是，如果您有任何特殊请求或希望看到的功能，请不要犹豫，在此Repo上打开一个GitHub问题。我们将很高兴接受任何反馈。

贡献

此工具是开源的，因此如果您希望看到某个特定功能，可以打开一个问题或提交PR，Perigon团队将会审查它。

本地开发

我们使用bun进行包管理。

环境变量

将以下环境变量添加到.dev.vars文件中：

变量	描述
ANTHROPIC_API_KEY	Anthropic API密钥（用于演示环境）
PERIGON_API_KEY	Perigon API密钥（用于演示环境）

如果您想为MCP演示环境（工具检查器和聊天）做出贡献，请确保修改您的网络主机文件（mac上的/etc/hosts）以包含以下内容：

127.0.0.1 local-mcp.perigon.io

这将允许您在进行本地开发时使用perigon.io的cookie。

# 安装依赖
bun i
# 运行mcp服务器和mcp演示环境
bun dev