MCP客户端服务器示例

一个展示模型上下文协议(MCP)的最小工作示例,用于注册工具、暴露给LLM并动态调用这些工具。

  • by Kamwebdev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Kamwebdev/Mcp-simple-client-server

使用说明

Mcp简单客户端服务器

概述

mcp简单客户端服务器是 模型上下文协议(MCP)——展示如何:

  • 在MCP服务器上注册工具,
  • 将它们暴露于LLM(Ollama、OpenAI兼容),
  • 让模型动态调用这些工具,
  • 将结果返回到对话循环中。

该项目有意简单明了,使其成为构建自己的MCP驱动的自动化、助手和本地AI集成的理想起点。

教程[PL]

所有代码和内容均由我编写。

可用零件

安装:

python -m venv .venv
.venv\Scripts\activate.bat
pip3 install -r requirements.txt

运行:

MCP服务器

要启动mcp服务器,请执行:

cd server
python mcp_server.py

运作原理

  1. 服务器启动FastMCP实例并注册所有可用工具。
  2. FastMCP通过HTTP在/mcp上自动公开这些工具。
  3. 客户端(或LLM)现在可以通过函数调用远程执行这些工具。

样本输出:

服务器输出

客户端

要运行我们的mcp服务器客户端,请在第二个终端中执行

cd client
cp .env_dist .env
python client.py

示例输出:

运作原理

  1. 客户端连接到MCP服务器。
  2. 它获取已注册的工具。
  3. 工具被转发到LLM(通过Ollama函数调用)。
  4. LLM可以:正常应答或请求工具执行。
  5. 该工具在MCP服务器上运行。
  6. 结果返回给LLM。
  7. 循环将继续,直到模型停止调用工具。