mcp_news

mcp_news

目次

• はじめに
• プロジェクトの構成
• 使用技術
• 要件
• Claude Desktop へのインストール方法
• 便利なリンク
• 貢献
• ライセンス
• 連絡先

はじめに

このプロジェクト mcp_news は、ウェブ上のニュースを検索して要約するツールを提供します。MCP（Model Context Protocol）プロトコルを使用することで、パスワードを介して安全に、言語モデルがニュース検索ツールとやり取りし、結果を構造化された形式で提示できます。特定のテーマについて、ジャーナリストによる調査を模した、簡潔で要点を押さえた要約を提供することを目的としています。

プロジェクトの構成

このプロジェクトでは、UFG（ゴイアス連邦大学）のSandeco Macedo教授が著書初心者向けMCPとA2A で説明しているMCPの内容を参考にしています。Anthropicの公式Model Context Protocolリポジトリのガイドラインにも従い、FastMCPパッケージのみを使用するシンプルなMCPサーバーです。

このMCPサーバーには、次のクラスがあります。

• tool search_news:
  • このツールは、ウェブ上のニュースを検索します。
  • 引数：
    • pesquisa (str)：検索する語句またはテーマです。
    • senha (str)：ツールの使用を許可するパスワードです。
  • 動作：入力されたパスワードが正しい場合（.envファイルで定義）、このツールはsmolagentsのWebSearchToolを使用してニュースを検索します。そうでない場合は、エラーメッセージを返します。
  • 戻り値：検索結果、またはエラーメッセージです。
• prompt acesso:
  • このプロンプトは、言語モデルでの使用を想定して設計されています。モデルに、経験豊富なジャーナリストとして振る舞うよう指示します。
  • 引数（モデルが入力してからtoolで使用します）：
    • senha (str)：tool search_newsにアクセスするためのパスワードです。
    • tema (str)：ニュース検索のテーマです。
  • 動作：プロンプトは、モデルに次の手順を実行するよう指示します。
    1. パスワードを確認します。
    2. temaと「news」という語を組み合わせて検索クエリを作成します。
    3. クエリとパスワードを指定してtool search_newsを呼び出します。
    4. toolの検索結果に基づき、指定された形式（タイトル、第1段落：要約、第2段落：補足情報）でニュースの要約を作成します。
  • 戻り値：ニュースの要約を含む書式付き文字列、またはパスワードが正しくない場合は失敗を示すメッセージです。

このプロジェクトについて話したい場合は、TalkToGitHub版をご覧ください。

このリポジトリについてもっと詳しく知りたいけれど、ポルトガル語がわからない方は、こちらの完全なチュートリアルをご覧ください：Codebase - mcp_news

使用技術

• MCP（Model Context Protocol）；
• Python；
• Claude Desktop；
• VSCode；
• Powershell。

必要条件

• Python がインストールされていること（バージョン 3.10 以降）；
• パッケージ uv がインストールされていること；
• Claude Desktop がインストールされていること。

Claude Desktop へのインストール方法

ここでは、VSCode のターミナル（ショートカット CTRL + J）を使用して、Windows 11 での手順を詳しく説明します。

1. 最新バージョンの Pythonをインストールします。

2. VSCode でターミナルを開き、次のコマンドで Python のバージョンを確認します。

   python --version
   

3. 次のコマンドで uv をインストールします。

   pip install uv
   

4. 正しくインストールされたことを確認するには、次のコマンドを実行します。

   uv
   

5. GitHub の Code > Download ZIP から、このプロジェクトの ZIP ファイルをマシンにダウンロードします。ZIP を展開し、任意のディレクトリにフォルダーを配置します。

6. VSCode で CTRL + O を押し、展開したフォルダーを選択します。

7. ターミナルに戻り、以下のコマンドを実行して新しい Python プロジェクトを初期化します。設定ファイルと依存関係が自動的に作成されます。

   uv init
   

8. このプロジェクトに必要な依存関係を追加します。

   uv add mcp[cli] dotenv smolagents[toolkit]
   

9. 以下のコマンドで問題がないことを確認します。

   mcp
   

重要

ターミナルに以下の情報が表示されれば、すべて正常です。

10. .env.example ファイルをクリックし、キーボードの F2 キーを押して .env のみに名前を変更します。

11. 以下の JSON を MCP サーバーから直接 claude_desktop_config.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. Desenvolvedor タブをクリックし、次に Editar configuração をクリックします。
11c. claude_desktop_config.json ファイルを探し、VSCode で正しく編集します。
11d. CTRL + S でファイルを保存します。
11e. Claude Desktop を閉じ、数秒後に再度開きます。
11f. 設定アイコンで、MCP ツール mcp_news が正しくインストールされていることを確認します。

ツールの名前は search_news です。

11g. 使用するには、「+」アイコンをクリックし、Adicionar do news オプションで、acesso という名前のプロンプトをクリックします。 プロンプト acesso をクリックするとフォームが表示されます。入力して Adicionar prompt ボタンをクリックし、Claude Desktop で実行してください。

役立つリンク

• Model Context Protocol の公式ドキュメント - Anthropic によるこの革新について、詳しく知ることができます
• Anthropic の公式サイト - Claude モデルの最新情報や研究について知ることができます
• Claude Desktop のダウンロード方法 - ダウンロードへの直接リンク
• VSCode のインストール方法- ダウンロードへの直接リンク
• uv パッケージの公式ドキュメント - uv の詳細や、Python で重要な理由について知ることができます
• venv — 仮想環境の作成 - venv の仕組みについて詳しく説明しています
• AI／LLM モデルのアイコン集 - AI エコシステムのアイコンを入手するのにとても便利なサイトです
• Devicon - テクノロジー全般のアイコンがそろった、こちらも充実したサイトです
• Smolagents - smolagents ライブラリの公式ドキュメント

貢献

貢献を歓迎します！このプロジェクトを改善するアイデアがあれば、お気軽にリポジトリをフォークしてください。

ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルをご覧ください。

お問い合わせ

Mário Lúcio - Prazo Certo®