@apify/actors-mcp-server/dist/mcp/actors.js

Model Context Protocol Server for Apify

import { ApifyClient } from '../apify-client.js';
import { MCP_STREAMABLE_ENDPOINT } from '../const.js';
/**
 * Returns the MCP server path for the given Actor ID.
 * Prioritizes the streamable transport path if available.
 * The `webServerMcpPath` is a string containing MCP endpoint or endpoints separated by commas.
 */
export function getActorMCPServerPath(actorDefinition) {
    if ('webServerMcpPath' in actorDefinition && typeof actorDefinition.webServerMcpPath === 'string') {
        const webServerMcpPath = actorDefinition.webServerMcpPath.trim();
        const paths = webServerMcpPath.split(',').map((path) => path.trim());
        // If there is only one path, return it directly
        if (paths.length === 1) {
            return paths[0];
        }
        // If there are multiple paths, prioritize the streamable transport path
        // otherwise return the first one.
        const streamablePath = paths.find((path) => path === MCP_STREAMABLE_ENDPOINT);
        if (streamablePath) {
            return streamablePath;
        }
        // Otherwise, return the first path
        return paths[0];
    }
    return null;
}
/**
 * Returns the MCP server URL for the given Actor ID.
 */
export async function getActorMCPServerURL(realActorId, mcpServerPath) {
    // TODO: get from API instead
    const standbyBaseUrl = process.env.HOSTNAME === 'mcp-securitybyobscurity.apify.com'
        ? 'securitybyobscurity.apify.actor' : 'apify.actor';
    const standbyUrl = await getActorStandbyURL(realActorId, standbyBaseUrl);
    return `${standbyUrl}${mcpServerPath}`;
}
/**
* Gets Actor ID from the Actor object.
*/
export async function getRealActorID(actorIdOrName, apifyToken) {
    const apifyClient = new ApifyClient({ token: apifyToken });
    const actor = apifyClient.actor(actorIdOrName);
    const info = await actor.get();
    if (!info) {
        throw new Error(`Actor ${actorIdOrName} not found`);
    }
    return info.id;
}
/**
* Returns standby URL for given Actor ID.
*/
export async function getActorStandbyURL(realActorId, standbyBaseUrl = 'apify.actor') {
    return `https://${realActorId}.${standbyBaseUrl}`;
}
export async function getActorDefinition(actorID, apifyToken) {
    const apifyClient = new ApifyClient({ token: apifyToken });
    const actor = apifyClient.actor(actorID);
    const defaultBuildClient = await actor.defaultBuild();
    const buildInfo = await defaultBuildClient.get();
    if (!buildInfo) {
        throw new Error(`Default build for Actor ${actorID} not found`);
    }
    const { actorDefinition } = buildInfo;
    if (!actorDefinition) {
        throw new Error(`Actor default build ${actorID} does not have Actor definition`);
    }
    return actorDefinition;
}
//# sourceMappingURL=actors.js.map