Perigon MCP Server

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

🛠️ 支持的工具

🐞 问题反馈与贡献

🐛 问题反馈

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

💪 贡献代码

此工具是开源的，如果你希望看到某个特定功能，可以创建问题或提交拉取请求，Perigon 的工作人员将进行审核。

💻 本地开发

我们使用 bun 进行包管理。

🛠️ 环境变量

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

如果你希望为 MCP 在线测试平台（工具检查器和聊天）做出贡献，请确保修改你的网络主机文件（Mac 上为 /etc/hosts）以包含以下内容：

127.0.0.1 local-mcp.perigon.io

这将允许你在本地开发时使用 Perigon.io 的 cookie。

# 安装依赖
bun i
# 运行 MCP 服务器和 MCP 在线测试平台
bun dev