内容
# mcp_news
[](https://python.org "Go to Python homepage")
## 目录
* [介绍](#介绍)
* [项目结构](#项目结构)
* [使用的技术](#使用的技术)
* [要求](#要求)
* [如何在Claude Desktop上安装](#如何在claude-desktop上安装)
* [有用的链接](#有用的链接)
* [贡献](#贡献)
* [许可证](#许可证)
* [联系](#联系)
## 介绍
该项目 `mcp_news` 提供了一个工具，用于从网络上搜索和总结新闻。利用MCP（模型上下文协议），它允许语言模型通过密码安全地与新闻搜索工具进行交互，并以结构化的方式呈现结果。其目的是提供关于特定主题的简明扼要的总结，模拟新闻调查的工作。
## 项目结构
该项目参考了UFG（戈亚斯联邦大学）Sandeco Macedo教授关于MCP的解释，来源于书籍 [MCP e A2A para Leigos](https://physia.com.br/mcp/)。这是一个简单的MCP-Server，仅使用FastMCP包，同时遵循Anthropic的 [Model Context Protocol](https://github.com/modelcontextprotocol/python-sdk) 官方库的指导。
该MCP-Server包含以下类：
* 工具 `search_news`：
* 该工具负责在网络上搜索新闻。
* 参数：
* `pesquisa` (str): 要搜索的术语或主题。
* `senha` (str): 用于授权使用该工具的密码。
* 工作原理：如果提供的密码正确（如在`.env`文件中定义），该工具将使用 `WebSearchTool`（来自 `smolagents`）进行新闻搜索。否则，将返回错误消息。
* 返回：搜索结果或错误消息。
* 提示 `acesso`：
* 该提示旨在供语言模型使用。它指示模型充当经验丰富的记者。
* 参数（供模型填写后在工具中使用）：
* `senha` (str): 访问 `tool search_news` 的密码。
* `tema` (str): 新闻搜索的主题。
* 工作原理：该提示引导模型：
1. 验证密码。
2. 结合 `tema` 和“news”一词形成搜索查询。
3. 使用查询和密码调用 `tool search_news`。
4. 根据工具的结果，以特定格式创建新闻摘要（标题，段落1：摘要，段落2：附加背景）。
* 返回：包含新闻摘要的格式化字符串，或如果密码不正确则指示失败。
如果想讨论这个项目，可以访问 [TalkToGitHub](https://talktogithub.com/marioluciofjr/mcp_news) 的版本。
想更好地理解这个仓库，但你不会说葡萄牙语？查看这个完整的教程：[`Codebase - mcp_news`](https://code2tutorial.com/tutorial/a67c8977-c7d2-49de-8374-c601a2893a00/index.md)
## 使用的技术
<div>
<img align="center" height="60" width="80" src="https://github.com/user-attachments/assets/c0604008-f730-413f-9c4e-9b06c0912692" />  
<img align="center" height="60" width="80" src="https://github.com/user-attachments/assets/76e7aca0-5321-4238-9742-164c20af5b4a" />  
<img align="center" height="60" width="80" src="https://github.com/user-attachments/assets/cf957637-962d-4548-87d4-bbde91fadc22" />  
<img align="center" height="60" width="80" src="https://github.com/user-attachments/assets/18c95cc3-d8bc-486c-b0cf-b5d128980176" />  
<img align="center" height="60" width="80" src="https://github.com/user-attachments/assets/abafaea5-eb57-4965-9130-7816280a8d84" />  
</div><br>
* MCP（模型上下文协议）；
* Python；
* Claude Desktop；
* VSCode；
* Powershell。
## 要求
* 安装Python（版本3.10或更高）；
* 安装 `uv` 包；
* 安装Claude Desktop。
## 如何在Claude Desktop上安装
现在我将详细说明在Windows 11上使用VSCode中的终端（快捷键 `CTRL` + `J`）的步骤：
1. 安装 [最新版本的Python](https://www.python.org/downloads/)。
2. 在VSCode中，使用终端检查Python版本，命令如下：
```powershell
python --version
```
3. 然后使用以下命令安装 `uv`：
```powershell
pip install uv
```
4. 为了确认一切正常，使用以下命令：
```powershell
uv
```
5. 从GitHub下载该项目的zip文件，路径为 `Code` > `Download ZIP`。将文件解压到您选择的目录。
6. 在VSCode中使用路径 `CTRL` + `O` 选择刚解压的文件夹。
7. 回到终端，使用以下命令初始化一个新的Python项目，自动创建配置文件和依赖项：
```powershell
uv init
```
8. 添加该项目所需的依赖项：
```powershell
uv add mcp[cli] dotenv smolagents[toolkit]
```
9. 使用以下命令检查一切是否正常：
```powershell
mcp
```
> [!IMPORTANT]
> 如果您的终端出现以下信息，则一切正常：
>
> 
10. 通过点击 `.env.example` 文件并使用键盘快捷键 F2 重命名该文件。仅重命名为 `.env`。
11. 在 `claude_desktop_config.json` 文件中直接安装MCP-Server的json如下：
```json
"news": {
"command": "uv",
"args": [
"--directory",
"C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_news",
"run",
"server.py"
]
}
```
> [!IMPORTANT]
> 我的目录大致是 "C://Users//meu_usuario//OneDrive//area_de_trabalho//MCPs//mcp_news"，但显然您需要填写您自己的 `mcp_news` 文件夹路径。
> [!IMPORTANT]
> 如果您已经正确安装了Claude Desktop，请按照路径访问您计算机上的 `claude_desktop_config.json` 文件。\
> 11a. 打开Claude Desktop，使用快捷键 `CTRL` + `,`\
> 11b. 点击 `开发者` 选项卡，然后点击 `编辑配置`\
> 11c. 找到 `claude_desktop_config.json` 文件并在VSCode中正确编辑\
> 11d. 使用 `CTRL` + `S` 保存文件\
> 11e. 关闭Claude Desktop，然后在几秒钟后重新打开\
> 11f. 在设置图标中检查MCP工具 `mcp_news` 是否正确安装。
>
> 
>
> 该工具被命名为 `search_news`。
>
> 11g. 要使用它，您需要点击 `+` 图标，然后在 `从新闻添加` 选项中点击提示 `acesso`。点击提示 `acesso` 后，将出现一个表单。只需填写并点击 `添加提示` 按钮，然后在Claude Desktop中执行。
## 有用的链接
* [Model Context Protocol 官方文档](https://modelcontextprotocol.io/introduction) - 您将了解Anthropic这一创新的所有细节。
* [Anthropic 官方网站](https://www.anthropic.com/) - 了解Claude模型的最新动态和研究。
* [如何下载Claude Desktop](https://claude.ai/download) - 直接下载链接。
* [如何安装VSCode](https://code.visualstudio.com/download) - 直接下载链接。
* [uv 包的官方文档](https://docs.astral.sh/uv/) - 了解 `uv` 的所有细节及其在Python中的重要性。
* [venv — 创建虚拟环境](https://docs.python.org/pt-br/3/library/venv.html) - 关于venv工作原理的完整解释。
* [AI/LLM模型图标集](https://lobehub.com/pt-BR/icons) - 一个很好的网站，可以获取AI生态系统的图标。
* [Devicon](https://devicon.dev/) - 一个非常全面的技术图标网站。
* [Smolagents](https://github.com/huggingface/smolagents) - smolagents库的官方文档。
## 贡献
欢迎贡献！如果您有改进此项目的想法，请随时对该仓库进行分叉。
## 许可证
该项目根据MIT许可证进行许可 - 请查看 [LICENSE](https://github.com/marioluciofjr/mcp_news/blob/main/LICENSE) 文件以获取详细信息。
## 联系
Mário Lúcio - Prazo Certo®
<div>
<a href="https://www.linkedin.com/in/marioluciofjr" target="_blank"><img src="https://img.shields.io/badge/-LinkedIn-%230077B5?style=for-the-badge&logo=linkedin&logoColor=white"></a>
<a href = "mailto:marioluciofjr@gmail.com" target="_blank"><img src="https://img.shields.io/badge/-Gmail-%23333?style=for-the-badge&logo=gmail&logoColor=white"></a>
<a href="https://prazocerto.me/contato" target="_blank"><img src="https://img.shields.io/badge/prazocerto.me/contato-230023?style=for-the-badge&logo=wordpress&logoColor=white"></a>
</div>
