用途
AllNewsAPI 的 MCP 服务器用于让 MCP 客户端访问 AllNewsAPI 的实时与历史新闻数据，包括来自全球来源的头条新闻。它面向支持 Model Context Protocol 的客户端，例如 Claude、Cursor、VS Code、Windsurf 等。
主要能力
- 按关键词、日期和筛选条件搜索文章。
- 获取头条新闻，可选择附加筛选。
- 检查套餐、请求限制与剩余配额（无参数）。
搜索与头条功能支持 AI 分析筛选：
ai_sentiment：文章整体情感（positive、negative、neutral）。ai_entity_name：文章中的命名实体（例如 United Nations）。ai_entity_type：实体类别（person、organization、location）。
返回的文章在可用时还可能包含 AI 情感评分、检测到的实体和简短 AI 摘要。
使用方式
需要 API key，可在 allnewsapi.com 获取。支持两种连接方式：
- 托管（无需安装）：将客户端指向托管服务器，并通过
X-API-Key请求头传入 API key。若偏好仅使用 URL 的配置，可使用https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE替代请求头。API key 可按以下优先级提供：X-API-Key请求头、apikey查询参数，或Authorization: Bearer YOUR_API_KEY_HERE请求头（供仅支持 bearer token 的客户端作为回退）。 - 本地：通过 npx 在您的机器上运行服务器，无需克隆或构建。也可用
ALLNEWSAPI_KEY环境变量代替--apikey提供密钥。
客户端配置：
- Claude：编辑配置（Settings → Developer → Edit Config），添加上面的本地或托管片段。完整指南：modelcontextprotocol.io/quickstart/user。
- Cursor：Settings → MCP → Add new MCP Server，命名为“AllNewsAPI”，选择命令类型并输入相应内容。
- VS Code：服务器随后可供 GitHub Copilot agent 使用。完整指南：VS Code MCP docs。
- Windsurf：将本地或托管片段添加到 MCP 配置。完整指南：Windsurf MCP docs。
- 终端添加——本地：或托管服务器。
- Cowork：运行在 Claude Desktop 内，将托管服务器作为自定义连接器添加——Customize → Connectors → +，输入带密钥的 URL；本地设置使用上述 Claude Desktop 配置。
- OpenWork：支持 MCP 的开源 Cowork 替代方案。可使用本地命令（
npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE）或上面的托管 URL，遵循 OpenWork 的 MCP 配置添加 AllNewsAPI。 - 其他任意 MCP 客户端：指向托管 URL（
https://mcp.allnewsapi.com/mcp）或运行npx allnewsapi-mcp@latest命令并附上您的 API key。
示例提示：
- “Get me the latest technology news from the US”
- “Find articles about climate change from European sources”
- “Show me top business headlines from the past week”
- “Find positive news about renewable energy”
- “Show me articles mentioning Apple as an organization”
- “Check my API usage and remaining quota”
适用场景
适合需要在支持 MCP 的客户端内直接检索全球新闻、按关键词或主题查找报道、获取特定时间范围头条、按情感或实体做 AI 分析筛选，以及查看 API 配额用量的场景。
限制
部分高级筛选——country、region、category、publisher、lang、attributes 和 sortby——需要付费套餐。在免费套餐中，请使用 search-news 配合 q 和 max。定价详见其定价页面。可接受的取值完整列表位于 AllNewsAPI 文档。
