MCP Leanring

🚀 MCP（Model Context Protocol）使用说明

MCP（Model Context Protocol）是一个用于连接客户端和大语言模型（LLM）的协议，能助力客户端与如Gemini等LLM实现交互。本文将详细介绍如何使用Cline作为客户端，与大语言模型进行交互。

参考链接：

• MCP 官方文档
• 知乎文章

🚀 快速开始

若想快速使用MCP与大语言模型交互，可按以下步骤操作：

1. 克隆代码仓库：

   git clone <repo_path>
   cd <repo>
   

2. 安装 uv 环境：
   • 如果没有安装，运行以下命令：

     uv install
     

3. 运行脚本：

   uv run script.py
   

✨ 主要特性

MCP（Model Context Protocol）作为连接客户端和大语言模型（LLM）的协议，具有以下主要特性：

• 连接性：能够有效连接客户端与大语言模型（LLM），实现两者之间的交互。
• 工具支持：服务器可用于生成工具，如 src/calculate.py 和 src/datawale.py 中展示的工具。
• 可配置性：通过 mcp-config.json 配置文件，可灵活配置LLM模型、API密钥以及工具等信息。
• 可重用性：Prompts 可定义可重用的提示模板和工作流。

📦 安装指南

(1) 安装 Cline 插件

在 VSCode 中安装 Cline 插件，步骤如下：

• 打开 VSCode。
• 进入插件市场，搜索并安装 Cline。

(2) 配置 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，将配置文件添加进去。

💻 使用示例

基础用法

(1) 运行服务器

确保 MCP 服务器始终运行，以便客户端进行通信。运行命令如下：

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

(2) 直接运行工具

如果没有安装 uv，可以直接运行工具脚本（如 txt_counter.py），但需要手动修改端口。

高级用法

(1) 使用 Cline 插件

在 VSCode 中使用 Cline 插件与大语言模型交互，步骤如下：

1. 打开要使用的文件夹。
2. 确保安装了 Cline 插件。
3. 在终端中运行以下命令启动 MCP 服务器：

   uv run script.py
   

4. 使用 Cline 插件调用工具。

(2) 示例代码

参考 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     // 是否必填
    }
  ]
}

🔧 技术细节

配置注意事项

• 命令路径：使用绝对路径，相对路径可能导致错误。
• 工具调用：确保服务器始终运行，以便客户端调用工具。