@modelcontextprotocol/server-everything/dist/tools/get-resource-links.js

MCP server that exercises all the features of the MCP protocol

import { z } from "zod";
import { textResource, textResourceUri, blobResourceUri, blobResource, } from "../resources/templates.js";
import { TOOL_ICONS } from "../server/icons.js";
// Tool input schema
const GetResourceLinksSchema = z.object({
    count: z
        .number()
        .min(1)
        .max(10)
        .default(3)
        .describe("Number of resource links to return (1-10)"),
});
// Tool configuration
const name = "get-resource-links";
const config = {
    title: "Get Resource Links Tool",
    description: "Returns up to ten resource links that reference different types of resources",
    inputSchema: GetResourceLinksSchema,
    icons: TOOL_ICONS,
    annotations: {
        readOnlyHint: true,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: false,
    },
};
/**
 * Registers the 'get-resource-links' tool.
 *
 * The registered tool retrieves a specified number of resource links and their metadata.
 * Resource links are dynamically generated as either text or binary blob resources,
 * based on their ID: even IDs are text resources, odd IDs are blob resources.

 * The response contains a "text" introductory block and multiple "resource_link" blocks.
 *
 * @param {McpServer} server - The McpServer instance where the tool will be registered.
 */
export const registerGetResourceLinksTool = (server) => {
    server.registerTool(name, config, async (args) => {
        const { count } = GetResourceLinksSchema.parse(args);
        // Add intro text content block
        const content = [];
        content.push({
            type: "text",
            text: `Here are ${count} resource links to resources available in this server:`,
        });
        // Create resource link content blocks
        for (let resourceId = 1; resourceId <= count; resourceId++) {
            // Even resourceIds are text resources, odd ones are blob resources
            const isText = resourceId % 2 === 0;
            const uri = isText
                ? textResourceUri(resourceId)
                : blobResourceUri(resourceId);
            // Get resource based on the resource type
            const resource = isText
                ? textResource(uri, resourceId)
                : blobResource(uri, resourceId);
            content.push({
                type: "resource_link",
                uri: resource.uri,
                name: `${isText ? "Text" : "Blob"} Resource ${resourceId}`,
                description: `Resource ${resourceId}: ${resource.mimeType === "text/plain"
                    ? "plaintext resource"
                    : "binary blob resource"}`,
                mimeType: resource.mimeType,
            });
        }
        return { content };
    });
};