跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

基于 AI 快速开发 MCP 服务插件及部署测试指南

综述由AI生成介绍如何利用 AI 辅助开发 MCP(模型上下文协议)服务插件。内容包括 MCP 简介、基于 FastMCP 框架的代码生成、数据库表创建、本地调试与 HTTP 服务启动。随后讲解 Windows 环境下的线上部署流程,涉及 Python 依赖安装、Nginx 反向代理配置及域名绑定。最后演示如何在智能体中集成并调用该 MCP 插件,对比了 MCP 与 API 的区别,总结了全流程实践要点。

氛围发布于 2026/4/6更新于 2026/5/1724 浏览
基于 AI 快速开发 MCP 服务插件及部署测试指南

MCP 简介

MCP(Model Context Protocol,模型上下文协议)是专为大语言模型(LLM)应用设计的开放协议,旨在实现 LLM 与外部工具和数据源的无缝集成。它通过统一的接口规范,将原本分散的 API 工具集成简化为'即插即用'模式,解决传统 API 工具中存在的多协议适配、高开发成本等问题。

特别注意:等你跑通一遍 MCP 后,回过来再看一遍 MCP 的解释,你就会对 MCP 模型上下文协议这个概念有所了解,确实是上下文。

图片描述

MCP(Model Context Protocol)可以理解为让 AI 模型(比如 ChatGPT)连接外部工具的'万能插座'。

简单来说:

  • 以前 AI 只能靠自己的知识回答问题,现在通过 MCP,AI 可以安全地连接各种工具(比如读取文件、查询数据库、控制智能设备)。
  • 就像给你的电脑插上 U 盘或打印机一样,MCP 让 AI 瞬间获得新能力,而且开发者可以轻松为 AI 创建新工具。
  • 整个过程安全可控,AI 只能使用你明确允许的工具,不会越权访问。

举个例子:有了 MCP,你可以直接对 AI 说'帮我总结昨天写的文档',AI 就会通过 MCP 读取你的文档并生成摘要,而之前这是做不到的。

下面将通过通义灵码插件来体验下 MCP 简单的开发和使用过程。

安装插件

使用 VSCode 进行开发,其核心辅助工具是'通义灵码'插件。安装非常简单,只需在 VSCode 扩展商店中搜索'Lingma'并安装,登录后即可开始使用它辅助 MCP 开发。

图片描述

MCP 开发

本次开发的 MCP 功能主要是查询数据库表,设置多个工具,可以通过博主名查询当前排名,也可以输出所有排名信息等工具。

创建表

CREATE TABLE top300_ranking (
  id INT NOT NULL AUTO_INCREMENT COMMENT '编号',
  total_rank INT NOT NULL COMMENT '总排名',
  ZEEKLOG_nickname VARCHAR(100) NOT NULL COMMENT '昵称',
  blog_homepage VARCHAR(255) NOT NULL COMMENT '博客主页',
  original_score INT NOT NULL COMMENT ,
  quality_score   COMMENT ,
  identity_score   COMMENT ,
  interaction_score   COMMENT ,
  ranking_score   COMMENT ,
  total_score   COMMENT ,
  add_time    COMMENT ,
  data_memo () COMMENT ,
  data_status TINYINT   COMMENT ,
   (id),
   KEY uk_total_rank (total_rank),
  INDEX idx_ZEEKLOG_nickname (ZEEKLOG_nickname),
  INDEX idx_total_score (total_score )
) ENGINEInnoDB  CHARSETutf8mb4 utf8mb4_unicode_ci COMMENT;
'原创博文得分'
INT
NOT NULL
'质量分得分'
INT
NOT NULL
'身份得分'
INT
NOT NULL
'互动得分'
INT
NOT NULL
'上榜得分'
INT
NOT NULL
'排名总分'
TIMESTAMP
DEFAULT
CURRENT_TIMESTAMP
'添加时间'
VARCHAR
500
'备注'
DEFAULT
1
'数据状态(1-正常,0-删除,或其他状态码)'
PRIMARY KEY
UNIQUE
DESC
=
DEFAULT
=
COLLATE
=
=
'TOP 300 榜单排名'

提示词

既然是 AI,那就用自然语言来让 AI 帮我们写代码实现 MCP 服务功能。 核心提示词就是:编写一个 FastMCP 框架实现 MCP Server 的脚手架工程,生成 python 文件。 目的是使用 python 对应的 mcp 框架。

编写一个 FastMCP 框架实现 MCP Server 的脚手架工程,生成 python 文件。 这个 MCP 服务主要实现如下功能: 1、获取某个博主排名信息,并通过【博客主页网址】获取当前博主个人主页信息以及发表文章篇数信息 调用此工具功能,必须调用查询条件 select * from top300_ranking where ZEEKLOG_nickname='昵称值参数' 2、获取汇总信息 输出汇总信息 sql 语句,可以按总分等汇总信息输出 【下面是 mysql 表信息】 CREATE TABLE top300_ranking (...)

根据提示词,最终会生成的代码和结构如下:

图片描述

安装依赖 AI 同时生成了 README.md 文件,帮我们把项目使用和启动等步骤都写得非常清楚,省了不少时间。

图片描述

配置数据库连接 根据自己的 mysql 连接信息进行填写。

图片描述

启动服务

第一次启动的时候可能会提示一些报错,直接复制报错信息让 AI 进行修复即可,经过多轮修复后,启动的效果如下:

图片描述

由于当前生成的代码是以 STDIO 方式启动的 MCP 服务,这里想使用的是 http 形式启动:

py app.py --transport http --host 127.0.0.1 --port 8080 --path /mcp

直接继续让 AI 进行修复兼容即可,基本不用写任何代码,全部由 AI 来完成。

图片描述

下面就是以 http 方式启动效果图。

图片描述

复制网址在浏览器上是可以直接访问的,显示下面信息说明启动成功。

图片描述

本地部署 MCP

点击右上角的用户信息,下拉点击个人设置。

图片描述

点击 MCP 服务。

图片描述

图片描述

点击 MCP 右上角的加号,相关信息填写如下: 名称:mcpZEEKLOG(根据自己业务来) 类型:SSE 或 Streamable HTTP(STDIO 这个类型还没试过) 服务地址:http://127.0.0.1:8080/mcp(就是刚刚启动的地址) 高级设置:暂时未用到,可留空。

图片描述

图片描述

MCP 服务这里就会自动获取对应工具信息。

图片描述

调用测试

询问: 全栈小 5 目前排名第几

AI 会优先查找可用的 MCP 服务插件,然后智能调用对应的工具获取信息。

图片描述

图片描述

从上图可以看到,已经成功调用到 MCP,并且查询数据库返回了相关信息,最后大模型根据从 MCP 工具中数据库表获取到的数据进行优化输出。博主询问的是全栈小 5 当前排名第几,不仅输出了博主是第几名,还有额外的具体各维度得分信息输出。

再测试个例子: 询问: 总分都有那些档次,划分档次并统计都有多少名博主

图片描述

图片描述

从上图可以看到,根据用户的提问 AI 能够准确知道调用获取所有排名的 MCP 工具,然后再进行汇总输出。

档次划分分数范围人数代表博主(示例)
顶级500 分1盼小辉丶(总分 500 分)
超高级470-489 分4夜郎 king(485 分)、青云交(480 分)、猫头虎(470 分)等
高级450-469 分61一键难忘、越重天、Francek Chen 等
中级440 分97比特魔法师、是 Dream 呀、全栈小 5 等
良好430 分107码农研究僧、工藤学编程、时光の尘等
中等420 分84几何心凉、Yeats_Liao、极客不孤独等
合格410 分46狮子也疯狂、繁依 Fanyi、架构进化论等
总计410-500 分300全体博主

到此,本地化部署 MCP 服务插件就算完成了,虽然过程中会出现一些问题,但是基本都是可以通过 AI 进行多轮询问得到解决,并且在过程中基本没有写过一行代码,全程由 AI 来完成,实现思路由我们自己通过自然语言来控制。

线上部署

本次部署环境选定为 Windows。具体步骤为:首先在服务器上运行 MCP 服务的 Python 程序,随后配置 Nginx 反向代理,并绑定域名以实现外网访问。

上传源码

直接将本地 python 代码上传到外网服务里。

图片描述

安装 Python

在启动前确保已经安装了 python 相关软件。 安装 python 软件的 cmd 命令,直接通过链接下载安装。

# 下载 Python 安装程序 curl -o python-installer.exe https://www.python.org/ftp/python/3.14.0/python-3.14.0-amd64.exe 

或者直接下载进行安装(推荐用这个方式,下载速度比较快)。

图片描述

cmd 命令:python --version,能够显示版本号则标识已经安装成功。

图片描述

安装依赖

直接在当前 python 文件目录执行 cmd 命令,README.md 这个文件里也有具体步骤:

pip install-r requirements.txt 

图片描述

启动服务

在当前目录下,执行下面命令启动服务。

py app.py --transport http --host 127.0.0.1 --port 8080 --path /mcp

图片描述

nginx 反向代理

在上一步,MCP 服务已在服务器的本地环境成功启动。 接下来,需配置 Nginx 反向代理,将本地服务映射至公网域名,以实现通过域名访问。 nginx windows 版本下载地址:https://nginx.org/en/download.html

图片描述

建议解压到 mcp 所在同级目录。

图片描述

修改 nginx.conf 文件内容,由于博主的 80 端口已经被占用,这里使用其他端口号测试。

worker_processes 1; # 必须要有 events 块
events {
    worker_connections 1024;
}
http {
    include mime.types;
    default_type application/octet-stream;
    sendfile on;
    keepalive_timeout 65;
    # 您的反向代理配置
    server {
        listen 8081;
        server_name 自己域名;
        location / {
            proxy_pass http://127.0.0.1:8080;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
            proxy_connect_timeout 60s;
            proxy_send_timeout 60s;
            proxy_read_timeout 60s;
        }
    }
    # 可选:默认的 localhost 服务器
    server {
        listen 8081;
        server_name localhost;
        location / {
            root html;
            index index.html index.htm;
        }
        error_page 500 502 503 504 /50x.html;
        location = /50x.html {
            root html;
        }
    }
}

设置 bat 启动文件。

@echo off
cd C:\web\mcp_ZEEKLOG\nginx
start nginx.exe
echo Nginx started.
pause

图片描述

本地测试

直接在 VSCode 里通过域名方式来添加 MCP。

图片描述

上架 MCP

非常简单,和在 VSCode 里手动添加类似。

图片描述

图片描述

工具调试。

图片描述

图片描述

图片描述

使用 MCP

创建一个智能体并使用 MCP,这里主要是用来测试,所以简单创建一个智能体引用 MCP 即可查看效果。

图片描述

到此,MCP 的开发、本地部署、线上部署、智能体使用 MCP 就搞定啦。

MCP 和 API 区别

在开发 MCP 前有个疑问,为啥不直接用 api 就得了,非得出来个 MCP,实际上他们也都是类似调用的一个地址,所以,这里还是要了解下他们之间的区别,也能知道 MCP 的核心价值。

特性维度APIMCP
全称与定义应用程序编程接口
一种通用技术标准与规范,定义了软件组件之间如何通信。
模型上下文协议
一个具体的协议和框架,专为让 AI 助手能安全、标准化地使用工具和数据源而设计。
本质与角色'通用语言'或'服务菜单'
任何软件(服务器、库、操作系统)都可以提供 API,任何客户端(其他软件或开发者)都可以调用。
'专用工具箱连接协议'
它是API 的使用者,也是一个标准化的包装层。它定义 AI(客户端)如何发现、调用工具(服务器),以及工具如何被描述。
核心目的实现系统间的集成与功能调用。
(例如:前端获取后端数据,App 集成支付功能)
安全、可控地扩展 AI 助手的能力边界。
(例如:让 AI 能读取数据库、执行命令、操作日历,而无需微调模型本身)
主要使用者开发者 编写代码来调用。
其他软件程序也可以调用。
AI 助手/智能体(如 Claude Desktop, Cursor 等)自动发现并调用。
(开发者负责为 AI创建MCP 工具)
关系与比喻基础技术设施。
好比电力系统(提供标准的电压和接口)。
建立在 API 之上的应用层协议。
好比一套标准插头和智能家电协议,让所有电器都能安全、即插即用地接入电力系统,并被智能管家统一控制。
关键特性- 风格多样(REST, GraphQL, gRPC 等)
- 注重性能、数据格式
- 认证和授权机制各异
- 标准化工具描述(名称、参数、schema)
- 资源概念(可读取的静态数据流)
- 强调安全与控制(主机严格控制可用工具)
- 动态发现(AI 启动时自动获取可用工具列表)
一个简单类比餐厅的纸质菜单和点餐流程。
(顾客需要自己阅读菜单、呼叫服务员、说出菜品)
餐厅的智能点餐平板。
(平板自动连接后,主动推送所有可点的菜,顾客(AI)只需描述需求,平板就能理解并格式化成标准订单发送后厨。)

了解之后,只要是后端开发语言,大部分都会有 MCP 插件库,像 Python、Java、C#都有类似 MCP 插件库直接可使用和封装 MCP。

总结

至此,MCP 的开发、本地与线上的部署应用,以及智能体调用 MCP 的全流程已完成。 简而言之,它与常规 API 的作用类似,但封装了特定领域的业务逻辑,是大模型功能调用的标准化接口。 感兴趣的朋友可以动手实践体验 MCP 服务插件。

目录

  1. MCP 简介
  2. 安装插件
  3. MCP 开发
  4. 创建表
  5. 提示词
  6. 启动服务
  7. 本地部署 MCP
  8. 调用测试
  9. 线上部署
  10. 上传源码
  11. 安装 Python
  12. 下载 Python 安装程序 curl -o python-installer.exe https://www.python.org/ftp/python/3.14.0/python-3.14.0-amd64.exe
  13. 安装依赖
  14. 启动服务
  15. nginx 反向代理
  16. 本地测试
  17. 上架 MCP
  18. 使用 MCP
  19. MCP 和 API 区别
  20. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 基于 SpringBoot 的在线房屋租赁管理系统设计与实现
  • LeetCode 202 快乐数:快慢指针解法详解
  • Flutter 三方库 Bavard 鸿蒙化适配:语义化聊天协议与机器人逻辑
  • Windows下安装运用高效轻量本地龙虾机器人ZeroClaw
  • KingbaseES SQL 防火墙技术解析与实战
  • Flutter 三方库 eth_sig_util 鸿蒙适配及以太坊签名技术指南
  • 程序员入门大模型:2024 年畅销书单推荐
  • FPGA 光通信 Aurora 64B/66B 协议开发指南
  • 无人机视角山区泥石流与滑坡图像识别数据集
  • Vue3+Node.js 实现大文件分片上传与断点续传
  • MySQL 数据库核心操作:创建、修改与备份实战
  • W17pro 平板 Android 4.0 至 4.1 升级及 Root 指南
  • Python 接入天远劳动仲裁 API 构建企业风控体系
  • 35 道常见前端 Vue 面试题解析
  • Llama-2-7b 昇腾 NPU 性能测评与部署优化指南
  • 前端地图开发基础:服务类型、坐标系与 SDK 简介
  • GitHub Copilot 网络代理配置与优化实战
  • Chaterm 开源 SRE 助手:基于 AI 的终端管理与自动化实践
  • IDEA 创建 Spring Boot Web 项目教程
  • Linux 五种 IO 模型

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online