MCP Leanring

🚀 MCP（Model Context Protocol）使用說明

MCP（Model Context Protocol）是一個用於連接客戶端和大語言模型（LLM）的協議，能實現客戶端與大語言模型的交互。本文將詳細介紹如何使用Cline作為客戶端，與Gemini等LLM進行交互。

🚀 快速開始

MCP（Model Context Protocol）可幫助客戶端與大語言模型（LLM）建立連接。接下來將介紹使用Cline客戶端與Gemini等LLM交互的具體步驟。

參考鏈接：

• MCP 官方文檔
• 知乎文章

✨ 主要特性

MCP 作為連接客戶端和大語言模型（LLM）的協議，具備以下特性：

• 支持使用 Cline 作為客戶端與 Gemini 等大語言模型進行交互。
• 可通過配置服務器生成工具，實現特定功能。
• 提供可重用的 Prompts 結構，方便定義提示模板和工作流。

📦 安裝指南

安裝 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 中使用 Cline 插件的步驟如下：

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
   

配置注意事項

• 命令路徑：使用絕對路徑，相對路徑可能導致錯誤。
• 工具調用：確保服務器始終運行，以便客戶端調用工具。