MCP（Model Context Protocol） 使用说明

参考链接：

• MCP 官方文档
• 知乎文章

1. 简介

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

2. 安装与配置

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

3. 使用工具

(1) 运行服务器

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

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

(2) 直接运行工具

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

4. 客户端使用示例

(1) 使用 Cline 插件

在 VSCode 中：

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)

5. Prompts 结构

Prompts 是用于定义可重用的提示模板和工作流，以下是其 JSON 格式：

{
  "name": string,              // 唯一标识符
  "description": string,      // 描述
  "arguments": [
    {
      "name": string,          // 参数名
      "description": string,   // 参数描述
      "required": boolean     // 是否必填
    }
  ]
}

6. 使用步骤

1. 克隆代码仓库：

   git clone <repo_path>
   cd <repo>
   

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

     uv install
     

3. 运行脚本：

   uv run script.py
   

7. 配置注意事项

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

更多详细信息，请参考官方文档和示例链接。