麦普新闻服务器

Name: 麦普新闻服务器
Author: marioluciofjr

作者：marioluciofjr4 星标更新：2025-06-06

安装使用来源：spider==github.com

项目介绍

技术文档摘要

mcp_news

介绍

此项目mcp_news提供了一个工具来搜索并总结网络上的新闻。通过使用MCP（模型上下文协议），它允许语言模型安全地与新闻搜索工具交互，通过密码，并以结构化的方式呈现结果。其目的是提供一个简洁且切题的主题摘要，模拟新闻调查工作。

项目结构

该项目参考了UFG（戈亚斯联邦大学）教授Sandeco Macedo关于MCP的解释，这些解释来自书籍MCP和A2A入门。这是一个简单的MCP-Server，仅使用FastMCP包，并遵循Anthropic官方仓库Model Context Protocol的指导。

此MCP-Server包含以下类：

工具 search_news：
- 此工具负责在网络上搜索新闻。
- 参数：
  - pesquisa (str): 要搜索的术语或主题。
  - senha (str): 用于授权使用该工具的密码。
- 运作方式：如果提供的密码正确（根据.env文件定义），则该工具使用WebSearchTool（来自smolagents）来搜索新闻。否则，返回错误消息。
- 返回值：搜索结果或错误消息。
提示 acesso：
- 此提示设计用于由语言模型使用。它指示模型扮演经验丰富的记者角色。
- 参数（供模型填充后用于工具）：
  - senha (str): 访问search_news工具的密码。
  - tema (str): 新闻搜索的主题。
- 运作方式：提示引导模型进行以下操作：
  1. 验证密码。
  2. 结合tema和“news”词形成搜索查询。
  3. 使用查询和密码调用search_news工具。
  4. 根据工具的结果，创建特定格式的新闻摘要（标题，段落1：摘要，段落2：附加背景）。
- 返回值：包含新闻摘要的格式化字符串，或者如果密码不正确，则返回失败指示。

如需讨论此项目，请访问TalkToGitHub版本。

想更好地理解这个仓库，但不懂葡萄牙语？查看这个完整的教程：Codebase - mcp_news

使用的技术

MCP（模型上下文协议）；
Python；
Claude Desktop；
VSCode；
PowerShell。

需求

安装Python（版本3.10或更高）；
安装uv包；
安装Claude Desktop。

如何在Claude Desktop上安装

现在我将在Windows 11上详细说明步骤，使用终端（快捷键CTRL + J）在VSCode中：

安装最新版本的Python
在VSCode中，使用终端检查Python版本，命令如下
```
python --version
```
然后安装uv，命令如下
```
pip install uv
```
使用以下命令确认一切正常
```
uv
```
从GitHub下载此项目的zip文件到您的机器，路径为Code > Download ZIP。将文件解压缩到您选择的目录。
在VSCode中使用快捷键CTRL + O并选择刚刚解压缩的文件夹
回到终端，使用以下命令初始化一个新的Python项目，自动创建配置文件和依赖项
```
uv init
```

添加此项目所需的依赖项

uv add mcp[cli] dotenv smolagents[toolkit]

使用以下命令确认一切正常
```
mcp
```

[!重要] 如果您的终端出现以下信息，说明一切正常

将.env.example文件重命名为.env，只需点击文件并使用键盘上的F2快捷键即可。

直接在claude_desktop_config.json文件中添加以下MCP-Server JSON

"news": {
  "command": "uv",
  "args": [
    "--directory",
    "C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_news",
    "run",
    "server.py"
  ]
}

[!重要] 我的目录类似于"C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_news"，但显然你应该放置你的mcp_news文件夹路径。

[!重要] 如果你已经正确安装了Claude Desktop，请按照以下路径访问claude_desktop_config.json文件 11a. 打开Claude Desktop，使用快捷键CTRL + , 11b. 点击开发者标签，然后点击编辑设置 11c. 查找并正确编辑claude_desktop_config.json文件 11d. 使用CTRL + S保存文件 11e. 关闭Claude Desktop，几秒钟后再打开 11f. 检查配置图标，确保MCP工具mcp_news已正确安装

该工具被命名为search_news。

11g. 要使用它，你需要点击+图标，在添加新闻选项中点击名为acesso的提示。点击acesso提示时，会出现一个表单。只需填写并点击添加提示按钮，然后在Claude Desktop中执行。

有用的链接

Model Context Protocol官方文档 - 了解Anthropic创新的所有细节
Anthropic官方网站 - 了解Claude模型的新进展和研究
如何下载Claude Desktop - 直接下载链接
如何安装VSCode - 直接下载链接
uv包官方文档 - 了解所有关于uv的细节及其在Python中的重要性
venv — 创建虚拟环境 - 完整解释虚拟环境的工作原理
AI/LLM模型图标集 - 获取AI生态系统图标的优秀网站
Devicon - 另一个非常全面的科技通用图标网站
Smolagents - Smolagents库的官方文档

贡献

欢迎贡献！如果你有改进此项目的建议，请随意fork此仓库。

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

联系

Mário Lúcio - Prazo Certo®