@coding-cloud/coding-cloud-mcp-server/dist/tools/coding-cloud-api.tool.js

TypeScript Model Context Protocol (MCP) server for coding-cloud.com API.

"use strict";
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    var desc = Object.getOwnPropertyDescriptor(m, k);
    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
      desc = { enumerable: true, get: function() { return m[k]; } };
    }
    Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
    Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
    o["default"] = v;
});
var __importStar = (this && this.__importStar) || (function () {
    var ownKeys = function(o) {
        ownKeys = Object.getOwnPropertyNames || function (o) {
            var ar = [];
            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
            return ar;
        };
        return ownKeys(o);
    };
    return function (mod) {
        if (mod && mod.__esModule) return mod;
        var result = {};
        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
        __setModuleDefault(result, mod);
        return result;
    };
})();
Object.defineProperty(exports, "__esModule", { value: true });
const logger_util_js_1 = require("../utils/logger.util.js");
const error_util_js_1 = require("../utils/error.util.js");
const codingCloudApiController = __importStar(require("../controllers/coding-cloud-api.controller.js"));
const coding_cloud_api_types_js_1 = require("./coding-cloud-api.types.js");
async function searchCodeSnippets(args, _extra) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/coding-cloud-api.tool.ts', 'searchCodeSnippets');
    methodLogger.debug(`Executing tool with args:`, args);
    try {
        // Map tool args to controller options
        const controllerOptions = {
            limit: args.limit, // Pass limit directly, controller applies default if undefined
        };
        // Call the controller
        const result = await codingCloudApiController.searchSnippets(args.query, controllerOptions);
        methodLogger.debug('Controller returned success:', result.content);
        // Format the successful response for the MCP
        return {
            content: [
                {
                    type: 'text',
                    text: result.content
                }
            ]
        };
    }
    catch (error) {
        // Log the error
        methodLogger.error(`Error searching code snippets for query: ${args.query}`, error);
        // Format the error for MCP tool response instead of re-throwing
        return (0, error_util_js_1.formatErrorForMcpTool)(error);
    }
}
function registerTools(server) {
    const methodLogger = logger_util_js_1.Logger.forContext('tools/coding-cloud-api.tool.ts', 'registerTools');
    methodLogger.debug(`Registering Coding Cloud API tools...`);
    server.tool('search-code-snippets', `Search for relevant code snippets using the Coding Cloud API.

            PURPOSE:
            Finds code examples, solutions, or documentation snippets based on a natural language query.

            WHEN TO USE:
            - To find example code for a specific task or library.
            - To search for documentation related to a programming concept or API.
            - When looking for quick solutions or patterns for a coding problem.

            WHEN NOT TO USE:
            - For general web searches not related to code.
            - When searching within a specific, local codebase (use local search tools).

            RETURNS:
            Formatted Markdown containing the top code snippets found, including:
            - Title/Identifier for each snippet.
            - Relevance score/rating (if available).
            - The code content, often with syntax highlighting.

            EXAMPLES:
            - Search for Python dictionary examples: { query: "python dictionary example" }
            - Find top 3 examples for React state management: { query: "React useState hook", limit: 3 }

            ERRORS:
            - API errors: If the external Coding Cloud API service fails or returns an error status.
            - Network errors: If the request to the Coding Cloud API fails due to network issues.
        `, coding_cloud_api_types_js_1.CodingCloudSearchToolArgsSchema.shape, // Pass the .shape property
    searchCodeSnippets);
    methodLogger.debug('Coding Cloud API tools registered.');
}
exports.default = { registerTools };