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

【MCP Node.js SDK 全栈进阶指南】初级篇（3）：MCP资源开发基础

news 来源：原创 2025/7/20 19:02:08

引言

在前两篇文章中，我们已经详细介绍了MCP开发环境的搭建以及基础服务器开发。本文作为MCP TypeScript-SDK系列的第三篇，将聚焦于MCP资源开发基础，包括静态资源与动态资源的开发、资源模板设计与参数提取、资源列表与发现机制，以及常见资源类型与最佳实践。通过本文的学习，你将能够设计和实现高效、灵活的MCP资源，为AI应用提供丰富的上下文信息。

一、静态资源与动态资源开发

在MCP中，资源是一种为AI模型提供上下文信息的数据结构。MCP将资源分为静态资源和动态资源两种类型，它们在实现方式和使用场景上有明显区别。

1. 静态资源开发

静态资源是指内容固定不变的资源，通常用于提供参考文档、配置信息或者固定知识库等。

1.1 基本静态资源创建

import { McpServer } from '@modelcontextprotocol/sdk';const server = new McpServer({name: 'resource-server',description: '资源示例服务器',version: '1.0.0',
});// 注册静态资源
server.registerResource({name: 'company-intro',description: '公司简介文档',content: '我们是一家专注于AI技术的创新公司，成立于2020年...',
});

1.2 从文件加载静态资源

import { McpServer } from '@modelcontextprotocol/sdk';
import fs from 'fs';
import path from 'path';const server = new McpServer({name: 'resource-server',description: '资源示例服务器',version: '1.0.0',
});// 从文件加载静态资源
const documentPath = path.join(__dirname, 'resources', 'product-manual.md');
const documentContent = fs.readFileSync(documentPath, 'utf-8');server.registerResource({name: 'product-manual',description: '产品使用手册',content: documentContent,metadata: {format: 'markdown',lastUpdated: new Date().toISOString(),version: '2.1.0',}
});

1.3 静态资源分组与组织

// 通过命名空间组织静态资源
server.registerResource({name: 'docs/api/authentication',description: 'API认证文档',content: '# API认证\n认证流程说明...',
});server.registerResource({name: 'docs/api/endpoints',description: 'API端点文档',content: '# API端点\n可用的API端点列表...',
});// 使用tags标记资源
server.registerResource({name: 'marketing-brand-guidelines',description: '品牌营销指南',content: '品牌标识使用规范...',metadata: {tags: ['marketing', 'brand', 'guidelines'],department: 'marketing',}
});

2. 动态资源开发

动态资源是指内容可以根据请求参数动态生成的资源，适用于需要实时数据或个性化内容的场景。

2.1 基本动态资源创建

import { McpServer } from '@modelcontextprotocol/sdk';
import { z } from 'zod';const server = new McpServer({name: 'dynamic-resource-server',description: '动态资源示例服务器',version: '1.0.0',
});// 注册动态资源
server.registerResource({name: 'weather-report',description: '实时天气报告',parameters: z.object({city: z.string().describe('城市名称'),unit: z.enum(['celsius', 'fahrenheit']).default('celsius').describe('温度单位'),}),resolve: async ({ city, unit }) => {// 从天气API获取数据const weatherData = await fetchWeatherData(city, unit);return {content: `${city}天气报告：温度${weatherData.temperature}${unit === 'celsius' ? '°C' : '°F'}，湿度${weatherData.humidity}%，天气${weatherData.condition}。`,metadata: {timestamp: new Date().toISOString(),provider: 'WeatherAPI',city: city,}};}
});// 模拟天气数据获取函数
async function fetchWeatherData(city: string, unit: string) {// 实际应用中，这里会调用真实的天气APIreturn {temperature: unit === 'celsius' ? 23 : 73.4,humidity: 65,condition: '晴天',};
}

2.2 复杂参数的动态资源

// 带有复杂参数的动态资源
server.registerResource({name: 'financial-report',description: '财务报表生成器',parameters: z.object({companyId: z.string().describe('公司ID'),period: z.object({start: z.string().describe('开始日期 (YYYY-MM-DD)'),end: z.string().describe('结束日期 (YYYY-MM-DD)'),}).describe('报告周期'),metrics: z.array(z.enum(['revenue', 'expenses', 'profit', 'cash-flow'])).default(['revenue', 'profit']).describe('要包含的指标'),format: z.enum(['summary', 'detailed']).default('summary').describe('报告格式'),}),resolve: async ({ companyId, period, metrics, format }) => {// 从数据库获取财务数据const financialData = await fetchFinancialData(companyId, period, metrics);// 根据format参数生成不同格式的报告const report = format === 'summary' ? generateSummaryReport(financialData) : generateDetailedReport(financialData);return {content: report,metadata: {companyId,period,metrics,generatedAt: new Date().toISOString(),}};}
});

2.3 分页和流式动态资源

// 支持分页的动态资源
server.registerResource({name: 'user-list',description: '用户列表',parameters: z.object({page: z.number().int().min(1).default(1).describe('页码'),pageSize: z.number().int().min(1).max(100).default

【MCP Node.js SDK 全栈进阶指南】初级篇（3）：MCP资源开发基础

引言在前两篇文章中，我们已经详细介绍了MCP开发环境的搭建以及基础服务器开发。本文作为MCP TypeScript-SDK系列的第三篇，将聚焦于MCP资源开发基础，包括静态资源与动态资源的开发、资源模板设计与参数提取、资源列表与发现机制，以及常见资源类型与最佳实践。通过本文的学…...

编程日记 2025/7/20 19:02:08

L2-1、打造稳定可控的 AI 输出 —— Prompt 模板与格式控制

一、为什么需要 Prompt 模板？ 在与 AI 模型交互时，我们经常会遇到输出不稳定、格式混乱的问题。Prompt 模板帮助我们解决这些问题，通过结构化的输入指令来获得可预测且一致的输出结果。模板的作用主要体现在： 固定输出格式&am…...

编程日记 2025/7/20 18:52:48

Java集成Zxing和OpenCV实现二维码生成与识别工具类

Java集成Zxing和OpenCV实现二维码生成与识别工具类本文将介绍如何使用Java集成Zxing和OpenCV库，实现二维码的生成和识别功能。识别方法支持多种输入形式，包括File对象、文件路径和Base64编码。一、环境准备添加Maven依赖 <dependencies><…...

编程日记 2025/7/20 18:42:11

jenkins pipeline ssh协议报错处理

一、jenkins版本 jenkins：2.492.3 openssh：OpenSSH_9.8p1, OpenSSL 3.3.1 # grep jenkins /etc/passwd jenkins:x:996:994:Jenkins Automation Server:/var/lib/jenkins:/bin/false 二、报错三、处理步骤1：手动添加目标主机密钥到Jenk…...

编程日记 2025/7/19 10:22:07

当OCR遇上“幻觉”：如何让AI更靠谱地“看懂”文字？

在数字化的世界里，OCR（光学字符识别）技术就像给机器装上了“电子眼”。但当这项技术遇上大语言模型，一个意想不到的问题出现了——AI竟然会像人类一样产生“幻觉”。想象一下，当你拿着模糊的财务报表扫描件时&#xff…...

编程日记 2025/6/29 10:34:42

vue watch监听路由，第一次进入不触发解决办法

“第一次进入的时候没触发，第二次就触发了”非常典型，它印证了路由监听（无论是 watch $route 还是 beforeRouteUpdate）主要是为了监听变化，而不是处理首次加载时的初始状态。当你通过 this.$router.push 导航到一个新…...

编程日记 2025/6/29 12:17:05

JVM考古现场（二十四）：逆熵者·时间晶体的永恒之战

"警告！时间晶体正在吞噬GC日志！" 我腰间的太极八卦镜突然迸发出刺目的量子辉光，终南山之巅的星宿大阵浮现出诡异的四维克莱因瓶拓扑——这是逆熵者文明穿越时空的拜帖！ 楔子：时间晶体的觉醒 🕯️…...

编程日记 2025/7/20 18:47:47

spring中使用netty-socketio部署到服务器（SSL、nginx转发）

spring中使用netty-socketio部署到服务器（SSL、nginx转发） 本文实现前端socket.io-client连接后端netty-socketio，并且部署到服务器上的示例，以及说明一些实现过程中可能遇到的错误。 socketio默认基于的路径是/socket.io 传输…...

编程日记 2025/6/29 10:14:24

qt.tlsbackend.ossl: Failed to load libssl/libcrypto.

我的环境是windows，QT6.3.2（msvc2019_64/mingw_64） 出错原因 QT没有正确加载OpenSSL。解决过程 1、确保安装的有openssl。文章结尾有个注意，是其他方式安装过openssl，环境变量有，但是QT找不到的问题。…...

编程日记 2025/6/29 10:33:54

【Python爬虫基础篇】--3.cookie和session

目录 1.cookie 1.1.定义 1.2.参数 1.3.分类 2.session 3.使用cookie登录微博 4.使用session登录 1.cookie 由于http是一个无状态的协议，请求与请求之间无法相互传递或者记录一些信息，cookie和session正是为了解决这个问题而产生。例子&#xff1…...

编程日记 2025/7/20 18:44:53

uView的u-modal不显示问题

问题分析：在项目中，其他页面显示正常，在这个页面显示不正常。问题解决： 一般的原因，诸如层级遮挡控制器true后，被其他逻辑又改为了false最可恨的一个原因 :showshow被编辑器的提示功能误写成了v-modal&qu…...

编程日记 2025/7/20 19:02:06

联易融科技：以科技赋能驱动经营反转与价值重估

行业去重周期下,轻量化发展成破局关键。当前,供应链金融行业正经历从"规模扩张"到"价值深耕"的转型期,降本增效、轻资产运营成为行业共识。联易融公告表示，截至2024年末,公司现金储备高达51亿元,显示出财务状况健康良好,流动资金持续充裕。董…...

编程日记 2025/7/16 19:50:29

Office文档图片批量提取工具

Office.Files.Images 是一款专注于从 Word、Excel、PPT 等 Office 文档中批量提取图片的轻量级工具，支持 .docx、.xlsx、.pptx 格式文件。该软件体积仅 ‌343KB‌，无需安装即可运行，通过拖拽操作实现快速解析与导出，尤其适合需批量…...

编程日记 2025/7/20 18:38:17

Python 设计模式：回调模式

1. 什么是回调函数？ 回调函数是指作为参数传递给另一个函数的函数。当这个函数执行到某个特定的点时，它会调用这个回调函数。回调函数通常用于处理异步操作、事件处理或在某些条件下执行特定的操作。回调函数的特点： 作为参数传递&#x…...

编程日记 2025/7/14 17:57:31

DCDC芯片，boost升压电路设计，MT3608 芯片深度解析：从架构到设计的全维度技术手册

一、硬件架构解析：电流模式升压 converter 的核心设计（一）电路拓扑与核心组件 MT3608 采用恒定频率峰值电流模式升压（Boost）转换器架构，核心由以下模块构成：集成功率 MOSFET 内置 80mΩ 导通电阻的 N 沟道 MOSFET，漏极（Drain）对应引脚 SW，源极（Source）内部接…...

编程日记 2025/6/29 10:29:44

大数据学习（112）-HIVE中的窗口函数

🍋🍋大数据学习🍋🍋 🔥系列专栏： 👑哲学语录: 用力所能及，改变世界。 💖如果觉得博主的文章还不错的话，请点赞👍收藏⭐️留言📝支持一…...

编程日记 2025/6/29 9:54:13

Hive学习

一、Hive 核心原理 1. Hive 架构与执行流程 Hive 是基于 Hadoop 的数据仓库工具，将 SQL 转化为分布式计算任务（MapReduce/Tez/Spark），核心组件如下： 元数据存储（Metastore）：存储表…...

编程日记 2025/7/18 21:48:49

前端开发核心知识详解：Vue2、JavaScript 与 CSS

一、Vue2 核心知识点 1. Vue2 的双向绑定原理 Vue2 实现双向绑定主要依赖数据劫持与发布 - 订阅者模式。利用Object.defineProperty方法对数据对象的属性进行劫持，为每个属性定义getter和setter。getter用于收集依赖，当视图中使用到该属性时&#xf…...

编程日记 2025/6/29 12:12:01

仅追加KV数据库

仅追加KV数据库 6.1 我们将要做什么在本章中，我们将创建一个基于文件的键值存储（KV Store），其核心是一个写时复制（Copy-on-Write, CoW）B 树。这种设计的目标是实现数据的持久性和原子性。 1. 设计概述 …...

编程日记 2025/6/29 19:34:16

【Java面试笔记：基础】8.对比Vector、ArrayList、LinkedList有何区别？

在Java中，Vector、ArrayList和LinkedList均实现了List接口，但它们在线程安全、数据结构、性能特性及应用场景上存在显著差异。 1. Vector、ArrayList 和 LinkedList 的区别 Vector： 线程安全：Vector 是线程安全的动态数组&#…...

编程日记 2025/6/29 19:37:36

Git分支管理方案

成都众望智慧有限公司Git分支管理方案采用轻量级Git Flow 敏捷版本控制策略，在保证稳定性的同时提升开发效率。以下是优化后的方案： 1. 精简分支模型（相比6-8人团队减少分支层级） 分支类型作用生命周期devops生产环境代码&am…...

编程日记 2025/6/29 19:33:52

SQL Tuning Advisor

什么是SQL Tuning Advisor STA可以用来优化那些已经被发现的高负载SQL. 默认情况下, Oracle数据库在自动维护窗口中自动认证那些有问题的SQL并且执行优化建议，找寻提升高负载SQL执行计划性能的方法. ** 如何查看自动优化维护窗口产生的报告? ** SQL> set ser…...

编程日记 2025/6/29 19:34:47

联易融出席深圳链主企业供应链金融座谈会，加速对接票交所系统

近日，深圳市委金融办组织召开全市链主企业供应链金融高质量发展座谈会。联易融作为供应链金融企业代表，与虾皮信息科技、电子元器件和集成电路国际交易中心等代表性机构以及行业协会、金融机构参加了会议。发展供应链金融是破解中小微企业融资难、融资…...

编程日记 2025/6/29 19:42:12

【前端记事】关于electron的入门使用

electron入门使用背景how to start第一步创建一个vite-vue3项目第二步装各种依赖第三步配置vite.config.jspackage.jsonelectron入口启动重写关闭、隐藏、最大化最小化背景最近对electron比较感兴趣，折腾一段时间后有了点眉目，记录一下 how to …...

编程日记 2025/6/29 19:37:52

【日历控件设计】 #include <QApplication> #include <QWidget> #include <QVBoxLayout> #include <QCalendarWidget> #include <QHBoxLayout> #include <QSpinBox> #include <QPushButton> #include <QLabel> #include <Q…...

编程日记 2025/6/29 19:35:21

Pycharm（十五）面向对象程序设计基础

目录一、定义类及使用类的成员二、self关键字介绍三、在类内部调用类中的函数 class 类名： 属性（类似于定义变量） 行为（类似于定义函数，只不过第一个形参要写self） 一、面向对象基本概述属性&…...

编程日记 2025/6/29 19:32:59

【C++游戏引擎开发】第21篇：基于物理渲染（PBR）——统计学解构材质与光影

引言宏观现象：人眼观察到的材质表面特性（如金属的高光锐利、石膏的漫反射柔和），本质上是微观结构对光线的统计平均结果。微观真相：任何看似平整的表面在放大后都呈现崎岖的微观几何。每个微表面（Microfacet）均为完美镜面，但大量微表面以不同朝向分布时，宏观上会表…...

编程日记 2025/6/29 19:37:44

flutter_slidable 插件使用

简介 flutter_slidable 是一个用于创建可滑动列表项的 Flutter 插件，它允许用户通过滑动来显示隐藏的操作按钮，比如删除、分享等功能。安装在 pubspec.yaml 中添加依赖（并运行 flutter pub get）： dependencies:fl…...

编程日记 2025/6/29 19:33:27

[论文阅读]ConfusedPilot: Confused Deputy Risks in RAG-based LLMs

ConfusedPilot: Confused Deputy Risks in RAG-based LLMs [2408.04870] ConfusedPilot: Confused Deputy Risks in RAG-based LLMs DEFCON AI Village 2024 文章是针对Copilot这样一个RAG服务提供平台的攻击在企业环境中整合人工智能工具（如 RAG）会…...

编程日记 2025/6/29 11:17:37

诠视科技MR眼镜如何使用头瞄点和UGUI交互

诠视科技MR眼镜如何使用头瞄点和UGUI交互要实现头瞄点计算单元确认键操作UGUI,最快捷的方式，右键直接添加XvHeadGazeInputController。添加以后会自动生成XvHeadGazeInputController到Head节点下面去。重要的几个参数讲解： scaleFactor&#xff1a…...

编程日记 2025/6/29 10:50:59

数据赋能（204）——原则与原理——原理方法

原理更多地关注事物本身的客观规律，而原则侧重于指导人们的行为和决策。原则与原理是两个常常被提及，但有所区别的概念。原则和原理在各个领域中都发挥着重要的作用。原理概念原理，则通常指的是自然科学和社会科学中具有普遍意义的基本规…...

编程日记 2025/6/29 10:30:53

代码随想录算法训练营第五十六天 | 108.冗余连接 109.冗余连接II

108.冗余连接题目链接：108. 冗余的边文章讲解：代码随想录思路： 题目说是无向图，返回一条可以删去的边，使得结果图是一个有着N个节点的树，如果有多个答案，则返回二维数组中最后出现的边。 …...

编程日记 2025/6/29 9:38:25

Git入门

一、Git 基础概念 1. 版本控制系统分类本地版本控制：如RCS，仅在本机保存历史版本集中式版本控制：如SVN，单一中央服务器管理代码分布式版本控制：如Git，每个开发者都有完整的仓库副本 2. Git 核心概念概…...

编程日记 2025/6/29 12:24:32

5G + 物联网：智能世界的催化剂，如何用Python打造下一代IoT应用？

5G 物联网：智能世界的催化剂，如何用Python打造下一代IoT应用？ 在数字化时代，物联网（IoT） 已成为智能产业的关键技术。从智能家居到智慧城市，再到工业4.0，我们的世界正在变得越来越…...

编程日记 2025/6/29 10:47:53

从单点突破到链式攻击：XSS 的渗透全路径解析

在网络安全领域，跨站脚本攻击（Cross-Site Scripting，简称 XSS）早已不是新鲜话题。然而，随着网络技术的迭代与应用场景的复杂化，攻击者不再满足于单一的 XSS 漏洞利用，而是将 XSS 与其他安全漏洞…...

编程日记 2025/6/29 10:28:49

spark和hadoop的对比和联系

一、Apache Hadoop 简介 Hadoop是一个由Apache基金会开发的开源分布式计算平台。它主要由Hadoop分布式文件系统（HDFS）和MapReduce计算框架组成。HDFS是为大规模数据存储而设计的，它将文件分割成多个数据块（block）&…...

编程日记 2025/6/29 10:38:26

【Vue3 / TypeScript】项目兼容低版本浏览器的全面指南

在当今前端开发领域，Vue3 和 TypeScript 已成为主流技术栈。然而，随着 JavaScript 语言的快速演进，许多现代特性在低版本浏览器中无法运行。本文将详细介绍如何使 Vue3 TypeScript 项目完美兼容 IE11 等低版本浏览器。一、理解兼容性挑战 …...

编程日记 2025/6/29 10:34:38

从零开始搭建你的个人博客：使用 GitHub Pages 免费部署静态网站

🌐 从零开始搭建你的个人博客：使用 GitHub Pages 免费部署静态网站在互联网时代，拥有一个属于自己的网站不仅是一种展示方式，更是一种技术能力的体现。今天我们将一步步学习如何通过 GitHub Pages 搭建一个免费的个人博客或简历…...

编程日记 2025/6/29 9:38:28

java 设计模式原型模式

简介原型模式（Prototype Pattern） 是一种创建型设计模式，它通过复制现有对象来生成新对象，而不是通过 new 关键字创建。核心思想是减少对象创建的开销，尤其是当对象初始化过程复杂或代价较高时。原型模式的核心实现…...

编程日记 2025/6/29 12:06:54

分别配置Github，Gitee的SSH链接

文章目录前言一、为第二个账号生成新的密钥对二、配置 SSH config 文件1.引入库使用 Host 别名进行 clone/push/pull注意扩展前言之前已经在电脑配置过Github一个仓库ssh链接，今天想配一个Gitee仓库的ssh链接。运行 ssh-keygen -t rsa提示已经存在&#xff0c…...

编程日记 2025/6/29 10:42:27

从零开始搭建Django博客②--Django的服务器内容搭建

本文主要在Ubuntu环境上搭建，为便于研究理解，采用SSH连接在虚拟机里的ubuntu-24.04.2-desktop系统搭建，当涉及一些文件操作部分便于通过桌面化进行理解，通过Nginx代理绑定域名，对外发布。此为从零开始搭建Django博客…...

编程日记 2025/6/29 12:09:50

如何用python脚本读取本地excel表格Workbook.xlsx将里面B2:B8内容，发给本地ollama大模型改写内容后写入对应C2:C8？

环境： python3.10 Win10专业版 ollama 火山引擎影刀问题描述：如何用python脚本读取本地excel表格Workbook.xlsx将里面B2:B8内容，发给本地ollama大模型改写内容后写入对应C2:C8？解决方案： 1.制作一个python脚本如下： import openpyxl import requests import…...

编程日记 2025/6/29 9:38:37

webpack详细打包配置，包含性能优化、资源处理...

以下是一个详细的 Webpack 5 配置示例，包含常见资源处理和性能优化方案： const path require(path); const webpack require(webpack); const { BundleAnalyzerPlugin } require(webpack-bundle-analyzer); const TerserPlugin require(terser-webp…...

编程日记 2025/6/29 10:34:14

MYSQL的binlog

用于备份恢复和主从复制 binlog 有 3 种格式类型，分别是 STATEMENT（默认格式）、ROW、 MIXED： STATEMENT：每一条修改数据的 SQL 都会被记录到 binlog 中（相当于记录了逻辑操作，所以针对这种格式…...

编程日记 2025/6/29 12:06:39

Saliency Driven Perceptual Image Compression阅读

2021 WACV 创新点常用的评估指标如MS-SSIM和PSNR不足以判断压缩技术的性能，它们与人类对相似性的感知不一致(2和3的MS-SSIM更高，但文字反而没那么清晰)。考虑显著区域的压缩（a）将更多的比特分配给显著区域（b&#…...

编程日记 2025/6/29 11:29:46

【C++ 类和数据抽象】构造函数

目录一、构造函数的基本概念 1.1 构造函数核心特性 1.2 构造函数的作用 1.3 构造函数类型体系二、构造函数的类型 2.1 默认构造函数 2.2 带参数的构造函数 2.3 拷贝构造函数 2.4 移动构造函数（C11 及以后） 三、初始化关键技术 3.1 成员初始…...

编程日记 2025/6/29 9:38:38

kotlin的kmp编程中遇到Unresolved reference ‘java‘问题

解决办法打开 File → Project Structure → Project 确保 Project SDK 是与你的 jvmToolchain 保持一致如果没有，点击右上角 Add SDK 添加 JDK 路径同步Sync 然后就正常了。 package org.example.projectimport androidx.compose.animation.AnimatedVi…...

编程日记 2025/6/29 11:55:13

鸿蒙Flutter仓库停止更新？

停止更新熟悉 Flutter 鸿蒙开发的小伙伴应该知道，Flutter 3.7.12 鸿蒙化 SDK 已经在开源鸿蒙社区发布快一年了， Flutter 3.22.x 的鸿蒙化适配一直由鸿蒙突击队仓库提供，最近有小伙伴反馈已经 2 个多月没有停止更新了，不少人以为停…...

编程日记 2025/6/29 10:37:51

【Ultralytics 使用yolo12 读取tiff 数据异常解决】

Ultralytics 使用yolo12 读取tiff 数据解决 Ultralytics 使用yolo12 读取tiff 数据异常解决 Ultralytics 使用yolo12 读取tiff 数据异常解决 Lib\site-packages\ultralytics\utils\patches.py def imread(filename: str, flags: int cv2.IMREAD_COLOR):"""Read…...

编程日记 2025/6/29 9:38:47

画布交互系统深度优化：从动态缩放、小地图到拖拽同步的全链路实现方案

画布交互系统深度优化：从动态缩放、小地图到拖拽同步的全链路实现方案在可视化画布系统开发中，高效的交互体验与稳定的性能表现是核心挑战。本文针对复杂场景下的五大核心需求，提供完整的技术实现方案，涵盖鼠标中心缩放、节点尺寸…...

编程日记 2025/6/29 9:40:50

引言