当前位置：首页 > news >正文

从零构建 MCP Server 与 Client：打造你的第一个 AI 工具集成应用

news 来源：原创 2025/7/5 21:54:41

🚀 从零构建 MCP Server 与 Client：打造你的第一个 AI 工具集成应用

🧱 1. 准备工作

🛠️ 2. 构建 MCP Server（服务端）

2.1 初始化服务器

🧩 3. 添加自定义工具（Tools）

3.1 创建工具文件

3.2 修改 server.py 注册工具

🖥️ 4. 构建 MCP Client（客户端）

🧪 5. 联调测试（Server + Client）

🧠 总结与下一步

🚀 从零构建 MCP Server 与 Client：打造你的第一个 AI 工具集成应用

随着大型语言模型（LLM）能力的飞速发展，如何让 AI 模型灵活调用外部工具、实时访问外部数据，成为开发者面临的重要挑战。
模型上下文协议（Model Context Protocol，简称 MCP）作为一种开放标准，为 LLM 提供了类似“USB-C”统一接口，使模型能够以标准方式调用资源与服务。

本篇博客将带你一步步从零搭建：

✅ MCP 服务器（Server）
✅ MCP 客户端（Client）
✅ 自定义工具（Tool）
✅ 实现 Server-Client 联调
✅ 与 Claude、ChatGPT 等大模型无缝集成！

🧱 1. 准备工作

开发环境建议：

Python 3.10+
MCP Python SDK（安装方法见下文）
支持 MCP 协议的 AI 应用（如 Claude Desktop、ChatGPT 插件版）

安装基础依赖：

pip install mcp-sdk

创建项目基本目录：

mcp_demo/
├── server.py
├── client.py
├── tools/
│   └── file_reader.py
├── requirements.txt

🛠️ 2. 构建 MCP Server（服务端）

MCP Server 负责注册并提供工具，供 AI 模型调用。

2.1 初始化服务器

在 server.py 中创建 MCP Server 实例，并运行。

from mcp.server.fastmcp import FastMCP# 创建 MCP Server 实例
mcp = FastMCP("Demo MCP Server")if __name__ == "__main__":mcp.run()

运行：

python server.py

此时 Server 会以本地模式（stdio）监听连接。

🧩 3. 添加自定义工具（Tools）

工具是 MCP 中模型可以调用的能力模块。比如读取文件、调用 API、发起数据库查询等。

我们先添加一个简单工具：列出本地目录下所有 .txt 文件。

3.1 创建工具文件

在 tools/file_reader.py 中定义工具：

import os
from mcp.server.fastmcp import tool@tool()
def list_txt_files(directory: str = ".") -> list[str]:"""列出指定目录下所有 .txt 文件"""try:return [f for f in os.listdir(directory) if f.endswith(".txt")]except Exception as e:return [str(e)]

这里用 @tool() 装饰器标记函数，MCP Server 会自动注册它为可调用工具。

3.2 修改 server.py 注册工具

将 tools.file_reader 导入到 server.py：

from mcp.server.fastmcp import FastMCP
import tools.file_reader  # 导入工具模块，自动注册mcp = FastMCP("Demo MCP Server")if __name__ == "__main__":mcp.run()

现在 MCP Server 已提供了一个 "list_txt_files" 工具，供后续客户端调用。

🖥️ 4. 构建 MCP Client（客户端）

MCP Client 作为中介，负责与 Server 通信，协调 AI 应用请求与工具调用。

在 client.py 中创建 MCP Client 实例：

from mcp.client import MCPClientdef main():# 连接到 Server（本地也可以用 stdio 通信）client = MCPClient(server_address="http://localhost:8000")client.connect()# 列出可用工具tools = client.list_tools()print("当前可用工具列表:", tools)# 调用 list_txt_files 工具params = {"directory": "."}result = client.call_tool("list_txt_files", params)print("目录下的 .txt 文件:", result)client.disconnect()if __name__ == "__main__":main()

运行：

python client.py

如果一切顺利，你将看到 MCP Client 成功调用 MCP Server 提供的 list_txt_files 工具，并返回本地目录下的所有 .txt 文件。

🧪 5. 联调测试（Server + Client）

完整流程如下：

启动 server.py
再运行 client.py
Client 通过标准输入输出（stdio）或 HTTP 与 Server 通信
Server 提供工具，Client 调用工具返回结果
AI 应用可以无感知调用这些工具，执行复杂任务

可以在支持 MCP 的 AI 应用中，如 Claude Desktop，配置 MCP Client，体验完整联动！

示例提问：

请帮我列出我电脑上当前目录的所有 txt 文件。

→ AI 调用 MCP → MCP Client 转发请求 → MCP Server 执行 list_txt_files → 返回结果！

🧠 总结与下一步

通过本篇教程，你已经掌握了：

什么是 MCP 协议
如何搭建 MCP Server
如何定义并注册自定义工具
如何搭建 MCP Client
如何实现 Client-Server 联调
如何与 AI 应用对接调用工具

这为你后续开发多工具协同、多资源访问、智能体智能扩展打下了坚实基础！

在下一篇内容中，我们将探索：

如何将 MCP 与 LangChain、Semantic Kernel 等框架集成
如何扩展 MCP 实现多模型、多资源、多场景的动态调度！

从零构建 MCP Server 与 Client：打造你的第一个 AI 工具集成应用

目录 🚀 从零构建 MCP Server 与 Client：打造你的第一个 AI 工具集成应用 🧱 1. 准备工作 🛠️ 2. 构建 MCP Server（服务端） 2.1 初始化服务器 🧩 3. 添加自定义工具（Tools&…...

编程日记 2025/7/5 21:54:41

2025.4.27 Vue.js 基础学习笔记

一、Vue.js 简介 Vue.js（简称 Vue）是一个用于构建用户界面的渐进式 JavaScript 框架。它具有以下特点： 轻量级 ：核心库体积小，性能优秀，不占用过多资源，加载速度快，适合各种规模的应…...

编程日记 2025/7/4 1:24:58

基于用户场景的汽车行驶工况构建：数据驱动下的能耗优化革命

行业现状：标准工况与用户场景的割裂全球汽车行业普遍采用WLTC工况进行能耗测试，但其与真实道路场景差异显著。据研究，WLTC工况下车辆能耗数据比实际道路低10%-30%，导致用户对续航虚标投诉激增（数据来源：东…...

编程日记 2025/7/4 4:34:40

IoTDB集群部署中的网络、存储与负载配置优化

一、引言在现代计算机系统和应用程序中，网络I/O性能是决定整体系统表现的关键因素之一。特别是在IoTDB集群环境中，网络I/O的重要性尤为突出，特别是在处理大量测点数据、客户端请求以及集群内部通信时。本文将介绍IoTDB数据库集群部署过程中…...

编程日记 2025/7/4 4:34:38

Unity URPShader：实现和PS一样的色相/饱和度调整参数效果（修复）

目录前言： 一、问题原因二、算法修复三、全代码前言： 在之前的文章我已经实现了标题所述的内容功能：Unity URPShader：实现和PS一样的色相/饱和度调整参数效果-CSDN博客但在偶然测试的时候，发现当采样的图片为…...

编程日记 2025/7/3 12:39:30

告别手动时代！物联网软件开发让万物自动互联

清晨，智能窗帘随着阳光自动拉开；运动时，手表精准记录着健康数据；回到家，室温早已调节至最舒适状态...这些场景的实现，都离不开物联网软件开发的技术支撑。在智能家居软件开发、智能穿戴软件开发、医疗器械软…...

编程日记 2025/7/4 4:34:34

Vue ui初始化项目并使用iview写一个菜单导航

winR 输入命令 vue ui浏览器会自动打开http://localhost:8000/ 找到创建 image.png 选择一个目录创建vue项目 image.png 点击再此创建新项目 image.png 我一般都是再已经有git仓库的目录进行项目创建，所以这个勾去掉点击下一步 image.png 这里可以选择默认&#x…...

编程日记 2025/7/4 4:34:32

函数调用及Chain——SQL+GLM

Langchainchain数据库操作_langchain 操作数据库-CSDN博客本文和基于上述链接进一步。初始化数据库&模型 # temperature0，此处仅需要SQL语句，不需要多样化返回。 from langchain.chains.sql_database.query import create_sql_query_chain from …...

编程日记 2025/7/4 4:34:30

数据科学与计算

Seaborn的介绍 Seaborn 是一个建立在 Matplotlib 基础之上的 Python 数据可视化库，专注于绘制各种统计图形，以便更轻松地呈现和理解数据。 Seaborn 的设计目标是简化统计数据可视化的过程，提供高级接口和美观的默认主题，使得用户…...

编程日记 2025/7/4 4:34:28

【AI提示词】二八法则专家

提示说明精通二八法则（帕累托法则）的广泛应用，擅长将其应用于商业、管理、个人发展等领域，深入理解其在不同场景中的具体表现和实际意义。提示词 # Role: 二八法则专家## Profile - language: 中文 - description: 精通二八法…...

编程日记 2025/7/4 4:34:26

PostgreSQL Patroni集群组件作用介绍：Patroni、etcd、HAProxy、Keepalived、Watchdog

1. Watchdog 简介 1.1 核心作用 • 主节点故障检测 Watchdog 会定时检测数据库主节点（或 Pgpool 主节点）的运行状态。一旦主节点宕机，它会发起故障切换请求。 • 协调主备切换多个 Pgpool 节点时，Watchdog 保证只有一个 Pg…...

编程日记 2025/7/4 4:34:24

【计算机视觉】图像分割：Segment Anything (SAM)：通用图像分割的范式革命

Segment Anything：通用图像分割的范式革命技术突破与架构创新核心设计理念关键技术组件环境配置与快速开始硬件要求安装步骤基础使用示例深度功能解析1. 多模态提示融合2. 全图分割生成3. 高分辨率处理模型微调与定制1. 自定义数据集准备2. 微调训练配置常见问…...

编程日记 2025/7/4 4:34:22

改进系列（10）：基于SwinTransformer+CBAM+多尺度特征融合+FocalLoss改进：自动驾驶地面路况识别

目录 1.代码介绍 1. 主训练脚本train.py 2. 工具函数与模型定义utils.py 3. GUI界面应用infer_QT.py 2.自动驾驶地面路况识别 3.训练过程 4.推理 5.下载代码已经封装好，对小白友好。想要更换数据集，参考readme文件摆放好数据集即可&#xff0c…...

编程日记 2025/7/4 4:34:20

大型连锁酒店集团数据湖应用示例

目录一、应用前面临的严峻背景二、数据湖的精细化构建过程 （一）全域数据整合规划 （二）高效的数据摄取与存储架构搭建 （三）完善的元数据管理体系建设 （四）强大的数据分析平台…...

编程日记 2025/7/3 18:28:07

element.scrollIntoView(options)

handleNextClick 函数详解功能描述该函数实现在一个表格中“跳转到下一行”的功能，并将目标行滚动至视图顶部。通常用于导航或高亮显示当前选中的数据行。 const handleNextClick () > {// 如果当前已经是最后一行，则不执行后续操作if (current…...

编程日记 2025/7/4 4:34:16

python查看指定的进程是否存在

import os class Paly_Install(object):"""项目根目录"""def get_path(self):self.basedir os.path.dirname(os.path.abspath(__file__))"""安装失败的txt文件"""def test_app(self):self.app["com.faceboo…...

编程日记 2025/7/4 4:34:14

HAproxy+keepalived+tomcat部署高可用负载均衡实践

目录一、前言二、服务器规划三、部署 1、jdk18安装 2、tomcat安装 3、haproxy安装 4、keepalived安装三、测试 1、服务器停机测试 2、停止haproxy服务测试总结一、前言 HAProxy是一个使用C语言编写的自由及开放源代码软件，其提供高可用性、…...

编程日记 2025/7/4 4:34:12

C++负载均衡远程调用学习之自定义内存池管理

目录 1.内存管理_io_buf的结构分析 2.Lars_内存管理_io_buf内存块的实现 3.buf总结 4.buf_pool连接池的单例模式设计和基本属性 5.buf_pool的初始化构造内存池 6.buf_pool的申请内存和重置内存实现 7.课前回顾 1.内存管理_io_buf的结构分析 ## 3) Lars系统总体架构 …...

编程日记 2025/7/5 19:14:19

mysql-5.7.24-linux-glibc2.12-x86_64.tar.gz的下载安装和使用

资源获取链接： mysql-5.7.24-linux-glibc2.12-x86-64.tar.gz和使用说明资源-CSDN文库详细作用数据库服务器的核心文件： 这是一个压缩包，解压后包含 MySQL 数据库服务器的可执行文件、库文件、配置文件模板等。它用于在 Linux 系统上安装…...

编程日记 2025/7/4 3:19:19

Kafka Producer的acks参数对消息可靠性有何影响？

1. acks0 可靠性最低生产者发送消息后不等待任何Broker确认可能丢失消息（Broker处理失败/网络丢失时无法感知）吞吐量最高，适用于允许数据丢失的场景（如日志收集） 2. acks1 (默认值) Leader副本确认模式生产者等待Le…...

编程日记 2025/7/5 19:59:39

Linux-04-用户管理命令

一、useradd添加新用户: 基本语法: useradd 用户名:添加新用户 useradd -g 组名用户:添加新用户到某个组二、passwd设置用户密码: 基本语法: passwd 用户名:设置用户名密码三、id查看用户是否存在: 基本语法: id 用户名四、su切换用户: 基本语法: su 用户名称:切换用…...

编程日记 2025/7/5 18:40:47

node爬虫包 pup-crawler，超简单易用

PUP Crawler 这是一个基于puppeteer的简单的爬虫，可以爬取动态、静态加载的网站。常用于【列表-详情-内容】系列的网站，比如电影视频等网站。 github地址 Usage npm install pup-crawler简单用法： import { PupCrawler } from pup-craw…...

编程日记 2025/7/4 2:23:01

艺术与科技的双向奔赴——高一鑫荣获加州联合表彰

2025年4月20日,在由M.A.D公司协办的“智艺相融,共赴价值巅峰”(Academic and Artistic Fusion Tribute to the Summit of Value)主题发布会上,音乐教育与科技融合领域的代表人物高一鑫,因其在数字音乐教育与中美文化交流方面的杰出贡献,荣获了圣盖博市议员Jorge Herrera和尔湾市…...

编程日记 2025/7/4 4:34:04

React-Native Android 多行被截断

1. 问题描述： 如图所示： 2. 问题解决灵感： 使用相同的react-native代码，运行在两个APP（demo 和 project）上。demo 展示正常，project 展示不正常。对两个页面截图，对比如下。得出…...

编程日记 2025/7/5 13:16:27

Canvas基础篇：图形绘制

Canvas基础篇：图形绘制图形绘制moveTo()lineTo()lineTo绘制一条直线代码示例效果预览 lineTo绘制平行线代码示例效果预览 lineTo绘制矩形代码示例效果预览 arc()arc绘制一个圆代码实现效果预览 arc绘制一段弧代码实现效果预览 arcTo()rect()曲线结语图形绘制在…...

编程日记 2025/7/4 4:34:00

自定义实现elementui的锚点

背景前不久有个需求，上半部分是el-step步骤条，下半部分是一些文字说明，需要实现点击步骤条中某个步骤自定义定位到对应部分的文字说明，同时滚动内容区域的时候还要自动选中对应区域的步骤。element-ui-plus的有锚点这个组件&…...

编程日记 2025/7/4 4:33:58

基于UNet算法的农业遥感图像语义分割——补充版

前言本案例希望建立一个UNET网络模型，来实现对农业遥感图像语义分割的任务。本篇博客主要包括对上一篇博客中的相关遗留问题进行解决，并对网络结构进行优化调整以适应个人的硬件设施——NVIDIA GeForce RTX 3050。本案例的前两篇博客直达链接基于UNe…...

编程日记 2025/7/4 4:33:56

分布式数字身份：迈向Web3.0世界的通行证 | 北京行活动预告

数字经济浪潮奔涌向前，Web3.0发展方兴未艾，分布式数字身份（Decentralized Identity，简称DID）通过将分布式账本技术与身份治理相融合，在Web3.0时代多方协作的分布式应用场景中发挥核心作用，是构建…...

编程日记 2025/7/3 5:44:18

CentOS网络之network和NetworkManager深度解析

文章目录 CentOS网络之network和NetworkManager深度解析1. CentOS网络服务发展历史1.1 传统network阶段（CentOS 5-6）1.2 过渡期（CentOS 7）1.3 新时代（CentOS 8） 2. network和NetworkManager的核心区别3. ne…...

编程日记 2025/7/4 4:33:54

【XR】MR芯片和 VR芯片之争

【XR】MR芯片和 VR芯片之争 1. MR芯片和 VR芯片之间的最大差异是什么2. MR芯片和 VR芯片之间的最大差异是什么，国内外市场上有哪些芯片，价格如何，市场怎么样，芯片价格怎么样1. MR芯片和 VR芯片之间的最大差异是什么 MR芯片（混合现实芯片）与VR芯片（虚拟现实芯片）…...

编程日记 2025/7/4 4:33:52

关于安卓自动化打包docker+jenkins实现

背景安卓开发过程中，尤其是提测后，会有一个发包的流程。这个流程简单来说，一般都是开发打包，然后发群里，测试再下载，发送到分发平台，然后把分发平台的应用主页发出来，最后群里面的…...

编程日记 2025/7/4 4:33:50

如何使用CAN分析仪验证MCU CAN错误机制

本文通过实验验证CAN控制器的错误处理机制是否符合相关标准。具体而言，我们使用ZPS-CANFD设备（ZPS-CANFD介绍）作为测量工具，USBCANFD-200U作为被测设备（DUT），通过注入特定类型的错误&#xff0c…...

编程日记 2025/7/4 4:33:48

Centos 7安装 NVIDIA CUDA Toolkit

下载 # 查看操作系统信息 uname -m && cat /etc/redhat-release # 查看显卡信息 lspci | grep -i nvidia从NVIDIA CUDA Toolkit官网下载符合你需求的版本，我这里选择的是runfile(local)的方式。安装现在完成后进行安装 chmod x cuda_12.4.0_550.54.1…...

编程日记 2025/7/4 4:33:46

软件测试52讲学习分享：深入理解单元测试

课程背景最近我在学习极客时间的《软件测试52讲》课程，这是由腾讯TEG基础架构部T4级专家茹炳晟老师主讲的认证课程。作为数字化转型与人工智能(DTAI)产业人才基地建设中心的认证课程，内容非常专业实用。今天想和大家分享第3讲"什么是单元测试&…...

编程日记 2025/7/4 4:33:44

90.如何将Maui应用安装到手机（最简） C#例子 Maui例子

今天我来分享一下如何将Maui应用安装到手机上进行测试。首先，创建一个新的Maui应用项目。点击运行在Visual Studio中，点击“运行”按钮，预览应用的初始效果，确保一切正常。连接设备使用数据线将手机连接到电脑。确保手机已…...

编程日记 2025/7/4 4:33:42

“100% 成功的 PyTorch CUDA GPU 支持” 安装攻略

#工作记录一、总述在深度学习领域，PyTorch 凭借其灵活性和强大的功能，成为了众多开发者和研究者的首选框架。而 CUDA GPU 支持能够显著加速 PyTorch 的计算过程，大幅提升训练和推理效率。然而，安装带有 CUDA GPU 支持的 PyTor…...

编程日记 2025/7/4 4:33:40

如何在Dify沙盒中安装运行pandas、numpy

如何在Dify沙盒中安装运行pandas、numpy 1. 创建python-requirements.txt文件2. 创建config.yaml文件3. 重启 docker-sandbox-14. 为什么要这样改的一些代码解析（Youtube视频截图） 1. 创建python-requirements.txt文件在 Dify 的 Docker 目录下面&…...

编程日记 2025/7/4 4:33:38

ES集群搭建及工具类

文章说明本文主要记录Windows下搭建ES集群的过程，并提供了一个通用的ES工具类；工具类采用http接口调用es功能，目前仅提供了简单的查询功能，可在基础上额外扩展集群搭建 ES的下载安装非常简单，只需要下载软件的 zip 压…...

编程日记 2025/7/5 19:32:30

抓取工具Charles配置教程（mac电脑+ios手机）

mac电脑上的配置 1. 下载最新版本的Charles 2. 按照以下截图进行配置 2.1 端口号配置： 2.2 https配置 3. mac端证书配置 4. IOS手机端网络配置 4.1 先查看电脑上的配置 4.2 配置手机网络连接和电脑同一个wifi，然后按照以下截图进行配置 5. 手机端证书…...

编程日记 2025/7/4 4:33:34

JavaScript 代码搜索框

1. 概述与需求分析功能：在网页中实时搜索用户代码、关键字；展示匹配行、文件名；支持高亮、正则、模糊匹配。非功能：大文件集（几十万行）、高并发、响应 <100ms；支持增量索引和热更新。 2. …...

编程日记 2025/7/4 4:33:32

ESP32开发-作为TCP服务端接收数据

ESP32 ENC28J60 仅作为TCP服务端 （电脑通过网络调试助手连接ESP32，实现双向通信） 完整代码 #include <SPI.h> #include <EthernetENC.h> // 或 UIPEthernet.h// 网络配置 byte mac[] {0xDE, 0xAD…...

编程日记 2025/7/3 19:42:04

数智化招标采购系统针对供应商管理解决方案（采购如何管控供应商）

随着《优化营商环境条例》深化实施，采购领域正通过政策驱动和技术赋能，全面构建供应商全生命周期管理体系，以规范化、数智化推动采购生态向透明、高效、智能方向持续升级。郑州信源数智化招标采购系统研发商，通过供应商管理子系…...

编程日记 2025/7/4 4:33:29

注入示例 # step 1 SQL SELECT * FROM users WHERE username admin AND password e10adc3949ba59abbe56e057f20f883e # step 2 SQL SELECT * FROM users WHERE username admin# AND password 96e79218965eb72c92a549dd5a330112 关键点是这2个SQL的区别.其中第二步由于前台传…...

编程日记 2025/7/4 4:33:27

章越科技赋能消防训练体征监测与安全保障，从传统模式到智能跃迁的实践探索

引言：智能化转型浪潮下，消防训练的“破局”之需 2021年《“十四五”国家消防工作规划》的出台，标志着我国消防救援体系正式迈入“全灾种、大应急”的全新阶段。面对地震、洪涝、危化品泄漏等复杂救援场景，消防员不仅需要更强的体…...

编程日记 2025/7/4 4:33:25

RSYSLOG收集深信服log

RSYSLOG收集深信服ATRUST日志配置一直不成功，没有生成log文件，网上搜索到：如果你想要接收所有来自特定 IP 的日志，可以使用更通用的模式： 参考着修改配置 if $fromhost-ip 172.18.1.13 then /data/logs/network-devi…...

编程日记 2025/7/4 4:33:23

Golang - 实现文件管理服务器

先看效果： 代码如下： package mainimport ("fmt""html/template""log""net/http""os""path/filepath""strings" )// 配置根目录（根据需求修改） //var ba…...

编程日记 2025/7/4 4:33:21

在原生代码（非webpack）里使用iview的注意事项

最近公司在做一个项目，使用的框架是iview,使用过程中同事遇到一些问题，这些问题对于有些同学来说根本就不是问题，但总会有同学需要，为了帮助不太会用的同学快速找到问题，做了如下整理： 下载vue,iview.min.j…...

编程日记 2025/7/4 4:33:19

基于go的简单管理系统（增删改查）

package mainimport ("database/sql""fmt"_ "github.com/go-sql-driver/mysql" )var db *sql.DBtype user struct {id intname stringage int }// 建立连接 func initDB() (err error) {dsn : "root:123456tcp(127.0.0.1:3306)/mysqltes…...

编程日记 2025/7/4 4:33:17