mcpField
M
mcp

mcp

本地服务
github.com/zhkzly开发工具082 周前更新

关于 mcp

这个示例项目介绍 MCP 服务端和客户端的设置,使用 Cline 作为客户端,并可选择 Gemini 作为大模型。项目包含示例工具,以及服务配置和运行说明。

主要功能

  1. 01Cline 客户端配置
  2. 02Gemini 模型选项
  3. 03示例服务端工具
  4. 04Python 客户端示例
  5. 05通过 uv 启动服务

适用场景

  1. 01通过 Cline 尝试调用 MCP 工具
  2. 02配置本地 MCP 服务
  3. 03了解基础 Python 客户端

MCP 相关

项目说明如何在 Cline 中配置 MCP 服务并通过 `uv` 运行,还包含用于与大模型通信的 Python 客户端示例。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

来自项目 README

mcp

这个是参考:

https://mp.weixin.qq.com/s/ULxokHOn4zVOgiLHf9DQUA,

https://zhuanlan.zhihu.com/p/20222456593

作出一些简单地补充,采用cline 当作client,可以选择gemini作为llm

1743774040990

文中似乎没有特意注明如何使用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将配置文件添加进去即可

1743774942455

1743774549113

command 这里必须使用绝对路径,相对路径会出现错误

调用工具的时候,应该是类似与首先执行server 使其始终运行,以便之后进行通信调用 类似于:/Users/{username}/.local/bin/uv --directory /Users/{username}... run txt_counter.py

--directory 切换执行目录。

1743774752161

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

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相关的内容,如果没有环境,会自动根据项目下的

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。