liaokongvfx/mcp-chinese-getting-started-guide

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

3579 stars 234 forks 品質 66 トレンド 27

Repository Install

モデルコンテキストプロトコル(MCP) - プログラミングの高速スタート

概要

モデルコンテキストプロトコル(MCP)は、大規模言語モデル(LLM)が外部とどのように相互作用するかを再定義する革新的なオープンソースプロトコルです。MCPは標準化されたアプローチを提供し、任意の大規模言語モデルがさまざまなデータソースやツールに容易に接続できるようにし、情報のシームレスなアクセスと処理を可能にします。MCPはAIアプリケーションのUSB-Cインターフェースのように機能し、AIモデルに異なるデータソースやツールを標準化して接続する方法を提供します。 - リソース - プロンプト - ツール - サンプリング - ルート - トランスポートトランスポートレイヤーほとんどの関数は実際にはClaudeクライアントにサービスを提供するため、本記事はMCPサーバーサービスや一般的な大規模言語モデルを書くことを好みます。したがって、本記事では主に「ツール」に焦点を当て、その他の機能は最後に簡単に説明します。その中で、MCPのトランスポート層はstdio(標準入出力)とSSE(サーバーがイベントを送信)という2つのプロトコルをサポートしています。stdioの方が一般的に使われるため、本記事ではstdioを例として説明します。この記事ではPythonの3.11バージョンを使用し、UVでPythonプロジェクトを管理します。記事の最後に、コードはGitHubに投稿されます。それでは、それでは始めましょう~ このセクションでは、ウェブ検索用のサーバーを実装します。まず、UVを使ってプロジェクトを初期化します。次に、サービスを実装するためにweb_search.pyというファイルを作成しましょう。MCPは2つのオブジェクトを提供します:mcp.server.FastMCPとmcp.server.Server。mcp.server.FastMCPはより高レベルのカプセル化で、ここではこれを使います。実装は非常にシンプルです。MCPは私たちに @mcp.tool()を提供します。実装関数をこのデコレーターで装飾するだけです。関数名はツール名、パラメータはツールパラメータ、ツール、パラメータ、返り値はコメントで記述されます。

概要（AI 翻訳）

[目次]

はじめに

MCPには以下の中核機能があります。

リソース
プロンプト:プロンプトワード
ツール
サンプリングサンプリング
ルーツ
トランスポート層

ほとんどの関数は実際にはClaudeクライアントにサービスを提供するため、本記事はMCPサーバーサービスや一般的な大規模言語モデルを書くことを好みます。したがって、本記事では主に「ツール」に焦点を当て、その他の機能は最後に簡単に説明します。

その中で、MCPのトランスポート層はstdio(標準入出力)とSSE(サーバーがイベントを送信)という2つのプロトコルをサポートしています。stdioの方が一般的に使われるため、本記事ではstdioを例として説明します。

この記事ではPythonの3.11バージョンを使用し、UVでPythonプロジェクトを管理します。記事の最後に、コードはGitHubに投稿されます。それでは、それでは始めましょう~

MCPサーバーの開発

このセクションでは、ウェブ検索用のサーバーを実装します。まず、UVを使ってプロジェクトを初期化します。

UV公式ドキュメント:https://docs.astral.sh/uv/

次に、web_search.pyというファイルを作成し、サービスを実装します。MCPは2つのオブジェクトを提供します:mcp.server.FastMCPとmcp.server.Server。mcp.server.FastMCPはより高レベルのパッケージで、ここではこれを使用します。

実装方法は非常にシンプルです。MCPは@mcp.tool()を提供し、実装関数をこのデコレーターで装飾するだけです。関数名はツール名、パラメータはツールパラメータ、ツールとパラメータはコメント、そして返り値で記述されます。

ここでは直接Zhipuインターフェースを使用しています。このインターフェースは関連する結果リンクの検索だけでなく、そのリンクから記事の要約を生成するのに役立ちます。~~、現在は無料です~~(すでに料金が開始されており、1エントリあたり0.03元です)。私たちにとって非常に適しています。

公式文書:https://bigmodel.cn/dev/api/search-tool/web-search-pro

API鍵生成アドレス:https://bigmodel.cn/usercenter/proj-mgmt/apikeys

最後に、サーバーを動かすコードを追加します。

MCPサーバーのデバッグ

この時点で、MCPサーバーの書き込みが完了します。

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

インストール

npx -y @modelcontextprotocol/inspector <command> <arg1> <arg2>

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "web-search-server": {
      "command": "uv",
      "args": [
        "--directory",
        "D:/projects/mcp_getting_started",
        "run",
        "web_search.py"
      ]
    }
  }
}