关于 mcp
这个示例项目介绍 MCP 服务端和客户端的设置,使用 Cline 作为客户端,并可选择 Gemini 作为大模型。项目包含示例工具,以及服务配置和运行说明。
主要功能
- 01Cline 客户端配置
- 02Gemini 模型选项
- 03示例服务端工具
- 04Python 客户端示例
- 05通过 uv 启动服务
适用场景
- 01通过 Cline 尝试调用 MCP 工具
- 02配置本地 MCP 服务
- 03了解基础 Python 客户端
MCP 相关
项目说明如何在 Cline 中配置 MCP 服务并通过 `uv` 运行,还包含用于与大模型通信的 Python 客户端示例。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
来自项目 READMEmcp
这个是参考:
https://mp.weixin.qq.com/s/ULxokHOn4zVOgiLHf9DQUA,
https://zhuanlan.zhihu.com/p/20222456593
作出一些简单地补充,采用cline 当作client,可以选择gemini作为llm

文中似乎没有特意注明如何使用claude desktop。这里可以选择多种client作为和llm沟通的平台(就是一个界面,也可以自己写)
当前可以选择的client 在llms-full.txt 中有列出来
server 主要是用来生成工具的,工具正如/src/calculate.py,src/datawale.py中展示的,所以一般而言,我们需要定义的就是这个工具(有人进行了开源可以自行选择,比如:https://composio.dev/)
在这里主要展示如何使用client
vscode 中安装Cline 插件,选择合适的模型,如上图
然后选择 mcp servers ,installed ,edit configuration将配置文件添加进去即可


command 这里必须使用绝对路径,相对路径会出现错误
调用工具的时候,应该是类似与首先执行server 使其始终运行,以便之后进行通信调用 类似于:/Users/{username}/.local/bin/uv --directory /Users/{username}... run txt_counter.py
--directory 切换执行目录。

也可以直接运行txt_counter.py,但是需要自己修改端口

client(我没有尝试)
src/mcp_client.py
参考:https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#quickstart
实际上的作用就是类似于一个ui,目的就是和llm进行通信,获取response(比如需要调用的工具,可以参考langchain)
llms-full.txt
官方的说明文档吧(第一个链接中有)
一些使用的简单示例
https://modelcontextprotocol.io/examples
prompts:的结构
有点类似与langchain bind_tools,但是功能更强大
https://modelcontextprotocol.io/docs/concepts/prompts#prompts
Prompts enable servers to define reusable prompt templates and workflows that clients can easily surface to users and LLMs. They provide a powerful way to standardize and share common LLM interactions.
Prompts are designed to be user-controlled , meaning they are exposed from servers to clients with the intention of the user being able to explicitly select them for use.
{
name: string; // Unique identifier for the prompt
description?: string; // Human-readable description
arguments?: [ // Optional list of arguments
{
name: string; // Argument identifier
description?: string; // Argument description
required?: boolean; // Whether argument is required
}
]
}
how to use:
git clone <repo_path>
cd
安装 uv
https://docs.astral.sh/uv/getting-started/installation/
uv run script.py
上面的指令会自动安装对应的环境到(./.venv)当前文件夹下,实际上在cline中配置mcp server的时候会自己运行uv相关的内容,如果没有环境,会自动根据项目下的
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。