JinDaGe - perigon-mcp-server MCP Details

article

README

🚀 Perigon MCP 服务器

这是 Perigon 新闻 API 的官方 MCP 服务器，为用户提供便捷、高效的新闻数据接入与处理服务。

📚 文档

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

🚀 快速开始

🌐 在线测试

你可以在我们的在线测试平台中试用 Perigon MCP 服务器。

⚠️ 重要提示

使用 MCP 需要有效的 Perigon API 密钥。在线测试平台要求你已在 Perigon 控制台完成身份验证。

🔗 连接服务器

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

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

支持的连接类型：

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

⚡ 快速设置示例

对于 MCP 客户端（使用 mcp-remote 的 SSE）：

{
  "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"
      }
    }
  }
}

对于 MCP 客户端（支持 SSE）：

{
  "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 部署

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

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

配置选项：

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

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

💬 提示示例

在向你的代理发出提示时，除非代理已经可以访问当前日期信息，否则我们建议提供当前日期（或获取日期的工具）。这是因为像 Claude 这样的一些模型否则会认为当前日期是它们的知识截止日期，从而经常检索到过时的信息。

新闻文章与报道：

给我今天美国排名前 5 的政治头条新闻。
今天纽约有哪些商业报道正在流行？
给我展示本周加利福尼亚州的最新科技新闻。
查找过去 3 天摇摆州的政治新闻。
给我展示过去一周与加密货币相关的报道。

记者与新闻来源：

查找德克萨斯州的本地新闻来源。
各大出版物中顶尖的商业记者有哪些？
查找报道可再生能源的记者，然后给我展示他们最近的文章。
哪些记者撰写关于气候政策的文章最多？
给我展示今天各大金融出版物的文章。

人物与公司：

查找制药公司 CEO 的近期新闻。
搜索特斯拉公司，然后查找关于他们的近期新闻报道。
给我展示电动汽车行业的公司。
搜索医疗保健报道中提到的政治家。
科技公司对人工智能监管有何看法？

🛠️ 支持的工具

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

🐞 问题反馈与贡献

🐛 问题反馈

此 MCP 服务器仍在开发中，我们正在确定用户希望通过此服务器解决的用例。如果你有任何特殊请求或希望看到的功能，请毫不犹豫地在本仓库中创建 GitHub 问题。我们将乐于接受任何反馈。

💪 贡献代码

此工具是开源的，如果你希望看到某个特定功能，可以创建问题或提交拉取请求，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

perigon-mcp-server