lokalise-mcp/dist/domains/contributors/contributors.resource.js

The Lokalise MCP Server brings Lokalise's localization power to Claude and AI assistants—manage projects, keys, and translations by chat.

import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { formatErrorForMcpResource } from "../../shared/utils/error.util.js";
import { Logger } from "../../shared/utils/logger.util.js";
import contributorsController from "./contributors.controller.js";
/**
 * Contributors MCP resources implementation.
 * Generated on 2025-07-08 for Team member and contributor management.
 */
const logger = Logger.forContext("contributors.resource.ts");
/**
 * Handle contributors collection resource requests
 */
async function handleContributorsCollectionResource(uri) {
    const methodLogger = logger.forMethod("handleContributorsCollectionResource");
    methodLogger.debug("Handling contributors collection resource request", {
        uri: uri.toString(),
    });
    try {
        // Extract project ID from path
        const pathParts = uri.pathname.split("/").filter(Boolean);
        if (pathParts.length < 2 || pathParts[0] !== "contributors") {
            throw new Error("Invalid resource URI format. Expected: lokalise://contributors/<project-id>");
        }
        const projectId = pathParts[1];
        // Extract query parameters
        const limit = uri.searchParams.get("limit");
        const page = uri.searchParams.get("page");
        // Build arguments
        const args = {
            projectId,
            limit: limit ? Number.parseInt(limit, 10) : undefined,
            page: page ? Number.parseInt(page, 10) : undefined,
        };
        // Call controller
        const result = await contributorsController.listContributors(args);
        return {
            contents: [
                {
                    uri: uri.toString(),
                    mimeType: "text/markdown",
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error("Resource handler failed", {
            error: error.message,
        });
        return formatErrorForMcpResource(error, uri.toString());
    }
}
/**
 * Handle contributor detail resource requests
 */
async function handleContributorDetailResource(uri) {
    const methodLogger = logger.forMethod("handleContributorDetailResource");
    methodLogger.debug("Handling contributor detail resource request", {
        uri: uri.toString(),
    });
    try {
        // Extract project ID and contributor ID from path
        const pathParts = uri.pathname.split("/").filter(Boolean);
        if (pathParts.length < 3 || pathParts[0] !== "contributors") {
            throw new Error("Invalid resource URI format. Expected: lokalise://contributors/<project-id>/<contributor-id>");
        }
        const projectId = pathParts[1];
        const contributorId = pathParts[2];
        // Build arguments
        const args = {
            projectId,
            contributorId: contributorId,
        };
        // Call controller
        const result = await contributorsController.getContributor(args);
        return {
            contents: [
                {
                    uri: uri.toString(),
                    mimeType: "text/markdown",
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error("Resource handler failed", {
            error: error.message,
        });
        return formatErrorForMcpResource(error, uri.toString());
    }
}
/**
 * Register all contributors resources with the MCP server
 */
function registerResources(server) {
    const methodLogger = logger.forMethod("registerResources");
    methodLogger.info("Registering contributors MCP resources");
    // Collection resource
    server.resource("lokalise-contributors", new ResourceTemplate("lokalise://contributors/{projectId}", {
        list: undefined, // No listing of resources needed
    }), async (uri) => handleContributorsCollectionResource(uri));
    // Detail resource
    server.resource("lokalise-contributor-details", new ResourceTemplate("lokalise://contributors/{projectId}/{contributorId}", {
        list: undefined, // No listing of resources needed
    }), async (uri) => handleContributorDetailResource(uri));
    methodLogger.info("Contributors MCP resources registered successfully");
}
// Export the domain resource implementation
const contributorsResource = {
    registerResources,
    getMeta() {
        return {
            name: "contributors",
            description: "Contributors resources",
            version: "1.0.0",
            resourcesCount: 2,
        };
    },
};
export default contributorsResource;