构建 MCP 服务器：第 2 部分 — 使用资源模板扩展资源

该图像是使用 AI 图像创建程序创建的。

这个故事是在多位人工智能助手的帮助下写成的。

这是构建MCP 服务器教程（共四部分）的第二部分。在第一部分中，我们使用基本资源创建了第一个 MCP 服务器。现在，我们将使用资源模板扩展服务器的功能。本文中的代码假设您从上次中断的地方继续学习。

什么是资源模板？

资源模板允许您使用 URI 模式定义动态资源。与具有固定 URI 的静态资源不同，模板允许您创建可根据参数生成 URI 和内容的资源。

可以将它们想象成 Web 框架中的 URL 模式，其中资源更具动态性，通常基于某些标签或 ID - 它们允许您使用单个定义匹配和处理整个资源系列。

为什么要使用资源模板？

当您需要处理动态数据、按需生成内容或创建基于参数的资源等时，资源模板非常强大。

以下是一些示例：

动态数据

“users://{userId}”  ->用户资料
“products://{sku}”  ->产品信息

用户：“你能告诉我关于用户 12345 的情况吗？”
AI 助手：“正在查找用户 12345......他于 2023 年加入，已进行 50 次购买。”

按需生成内容

“reports://{year}/{month}”  ->月度报告
“analytics://{dateRange}”  ->自定义分析

用户：“给我看看2024年3月的报告”
AI助手：“正在访问2024年3月的报告……与2月份相比，收入增长了15%。”

基于参数的资源

"search://{query}"  ->搜索结果
"filter://{type}/{value}"  ->过滤数据

用户：“查找所有超过 1000 美元的交易”
AI 助手：“使用过滤资源...找到 23 笔符合您条件的交易。”

组织我们的代码

我们再来改进一下上篇文章中构建的代码结构，分离一些关注点。首先，把处理程序拆分成一个新文件 (handlers.ts)，这样就不会太杂乱了：

// src/handlers.ts
import {ListResourcesRequestSchema,ReadResourceRequestSchema,ListResourceTemplatesRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";
import { type Server } from "@modelcontextprotocol/sdk/server/index.js";export const setupHandlers = (server: Server): void => {// List available resources when clients request themserver.setRequestHandler(ListResourcesRequestSchema, async () => {return {resources: [{uri: "hello://world",name: "Hello World Message",description: "A simple greeting message",mimeType: "text/plain",},],};});// Return resource content when clients request itserver.setRequestHandler(ReadResourceRequestSchema, async (request) => {if (request.params.uri === "hello://world") {return {contents: [{uri: "hello://world",text: "Hello, World! This is my first MCP resource.",},],};}throw new Error("Resource not found");});
};

更新我们的主要文件src/index.ts：

// src/index.ts
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { setupHandlers } from './handlers.js';const server = new Server({name: "hello-mcp",version: "1.0.0",},{capabilities: {resources: {},},}
);setupHandlers(server);// Start server using stdio transport
const transport = new StdioServerTransport();
await server.connect(transport);
console.info('{"jsonrpc": "2.0", "method": "log", "params": { "message": "Server running..." }}');

添加新资源

现在是时候添加我们的新资源模板了。

首先，让我们添加清单，以便 AI 助手知道它在那里。在资源清单（第一个参数为 的那个）src/handlers.js之后添加以下代码。hello://worldListResourcesRequestSchema

export const setupHandlers = (server: Server): void => {// Existing "hello://world" resource listing here ...// Resource Templatesserver.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({resourceTemplates: [{greetings: {uriTemplate: 'greetings://{name}',name: 'Personal Greeting',description: 'A personalized greeting message',mimeType: 'text/plain',},},],}));// Existing "hello://world" resource content here ... 
};

接下来我们可以添加内容处理程序。这不需要额外的请求处理程序。我们只需为这种格式的请求添加一个新的检查即可。

// Return resource content when clients request it
server.setRequestHandler(ReadResourceRequestSchema, async (request) => {// ... Existing content handler code// Template-based resource codeconst greetingExp = /^greetings:\/\/(.+)$/;const greetingMatch = request.params.uri.match(greetingExp);if (greetingMatch) {const name = decodeURIComponent(greetingMatch[1]);return {contents: [{uri: request.params.uri,text: `Hello, ${name}! Welcome to MCP.`,},],};}// ...
});

理解代码

处理程序组织

• 我们已将处理程序移至单独的文件以便更好地组织
• setupHandlers 函数封装了所有处理程序的设置
• 主文件保持干净且专注

模板定义

• 处理程序公开可用的模板 ListResourceTemplateRequestSchema
• 模板名称格式遵循RFC 6570{text} （用于表达参数化的URL ）
• 模板包括名称和描述等元数据

模板处理

• 处理程序现在检查模板匹配 ReadResourceRequestSchema
• 我们使用正则表达式格式从 URI 中提取名称参数
• 我们根据参数生成动态内容

使用检查器进行测试

在上一篇文章中，我们讨论了如何使用MCP 检查器。现在启动检查器：

npx tsc
npx @modelcontextprotocol/inspector node build/index.js

测试我们上次创建的静态资源，以确保它仍然有效：

• 点击“资源”选项卡
• 找到并点击“Hello World Message”
• 您应该会看到“Hello, World! 这是我的第一个 MCP 资源。”的消息。

测试模板：

• 点击“资源模板”选项卡
• 找到“个人问候语”
• 输入名字“Alice”

{"contents": [{"uri": "greetings://Alice","text": "Hello, Alice! Welcome to MCP."}]
}

使用 Claude Desktop 进行测试

这次您不需要在 Claude 中更新任何内容，但您可能需要重新加载（同时，确保您已经使用构建了服务npx tsc）。

正如我上一篇文章所述，我为 Mac 使用的 Claude Desktop 似乎还不支持资源，但您可以在其他支持 MCP 的工具中尝试此操作，例如 Cline，您可能必须专门使用支持 MCP 的模型，例如 Anthropic 的 Sonnet 3.5。

尝试以下示例（响应可能有所不同）：

静态资源：

用户： “问候语里有什么？” 
Claude： “问候语是：‘来自 MCP 的问候！这是您的第一个资源。’”

模板资源：

用户： “你能给爱丽丝找个问候语吗？”
克劳德： “我去看看个性化问候语……上面写着：‘你好，爱丽丝！欢迎来到 MCP。’”

列出可用资源：

用户：“有哪些资源和模板可用？” 
Claude：“服务器提供：
1. 静态‘问候语’资源
2. 可以为任何姓名创建自定义问候语的‘个人问候语’模板”

下一步是什么？

在第 3 部分中，我们将：

• 通过将资源和模板分离到各自的文件中，进一步改善代码组织
• 了解 MCP 提示以及它们与资源的区别
• 为我们的服务器添加提示功能
• 看看提示如何增强我们的问候功能

第 4 部分将通过向我们的服务器添加工具来完成我们的课程。

资源和其他阅读材料：

• Introduction - Model Context Protocol
• Cline - Visual Studio Marketplace
• RFC 6570: URI Template
• App unavailable \ Anthropic