MCP Leanring

🚀 MCP（Model Context Protocol）の使用説明

MCP（Model Context Protocol）は、クライアントと大規模言語モデル（LLM）を接続するためのプロトコルです。このドキュメントでは、Clineをクライアントとして使用し、GeminiなどのLLMとやり取りする方法を紹介します。

参考リンク：

• MCP 公式ドキュメント
• 知乎記事

🚀 クイックスタート

MCP（Model Context Protocol）を使って、クライアントと大規模言語モデル（LLM）を接続する方法を紹介します。ここでは、Clineをクライアントとして使用し、GeminiなどのLLMとのやり取りを行います。

✨ 主な機能

MCPは、クライアントと大規模言語モデル（LLM）を接続するためのプロトコルです。これにより、Clineをクライアントとして使用し、GeminiなどのLLMとのやり取りが可能になります。

📦 インストール

Cline プラグインのインストール

VSCodeで Cline プラグインをインストールします。

1. VSCodeを開きます。
2. プラグイン市場にアクセスし、Cline を検索してインストールします。

MCP サーバーの設定

MCPサーバーは、生成ツール（src/calculate.py や src/datawale.py で示されるツール）を生成するために使用されます。以下は設定手順です。

1. VSCodeのターミナルを開きます。
2. 以下のコマンドを実行して依存関係をインストールします。

   pip install mcp-server
   

3. mcp-config.json 設定ファイルを作成し、以下の内容を記述します。

   {
     "llm": {
       "model": "gemini",
       "api_key": "your_api_key"
     },
     "tools": [
       {
         "name": "txt_counter",
         "description": "Counts words in a text file.",
         "path": "src/txt_counter.py"
       }
     ]
   }
   

4. VSCodeで Cline プラグインの設定画面に移動します。
5. MCP Servers -> Installed を選択し、Edit Configuration をクリックして設定ファイルを追加します。

💻 使用例

基本的な使用法

サーバーの起動

MCPサーバーを常に実行して、クライアントが通信できるようにします。以下のコマンドを実行します。

/Users/{username}/.local/bin/uv --directory /Users/{username} run txt_counter.py

ツールの直接実行

uv がインストールされていない場合は、ツールスクリプト（txt_counter.py など）を直接実行できますが、ポートを手動で変更する必要があります。

高度な使用法

Cline プラグインの使用

VSCodeで以下の手順を実行します。

1. 使用するフォルダを開きます。
2. Cline プラグインがインストールされていることを確認します。
3. ターミナルで以下のコマンドを実行してMCPサーバーを起動します。

   uv run script.py
   

4. Clineプラグインを使用してツールを呼び出します。

コード例

MCP 公式の例を参考にしてください。

from mcp.client import Client

client = Client()
response = client.chat("What is 100 + 200?")
print(response)

📚 ドキュメント

Prompts 構造

Promptsは、再利用可能なプロンプトテンプレートとワークフローを定義するために使用されます。以下はそのJSON形式です。

{
  "name": string,              // 一意の識別子
  "description": string,      // 説明
  "arguments": [
    {
      "name": string,          // パラメータ名
      "description": string,   // パラメータの説明
      "required": boolean     // 必須かどうか
    }
  ]
}

使用手順

1. コードリポジトリをクローンします。

   git clone <repo_path>
   cd <repo>
   

2. uv 環境をインストールします。
   • インストールされていない場合は、以下のコマンドを実行します。

     uv install
     

3. スクリプトを実行します。

   uv run script.py
   

設定に関する注意事項

⚠️ 重要提示

• コマンドパス：絶対パスを使用してください。相対パスを使用するとエラーが発生する場合があります。
• ツールの呼び出し：クライアントがツールを呼び出せるように、サーバーを常に実行しておいてください。