dataforseo-mcp-server
Version:
A Model Context Protocol (MCP) server for the DataForSEO API, enabling modular and extensible integration of DataForSEO endpoints with support for both HTTP and SSE transports.
124 lines • 4.35 kB
JavaScript
import { z } from 'zod';
import { defaultGlobalToolConfig } from '../config/global.tool.js';
import { filterFields, parseFieldPaths } from '../utils/field-filter.js';
import { FieldConfigurationManager } from '../config/field-configuration.js';
export class BaseTool {
dataForSEOClient;
constructor(dataForSEOClient) {
this.dataForSEOClient = dataForSEOClient;
}
supportOnlyFullResponse() {
return false;
}
formatError(error) {
return error instanceof Error ? error.message : 'Unknown error';
}
getFilterExpression() {
if (defaultGlobalToolConfig.simpleFilter) {
// Permissive filter schema for LLM tool compatibility (e.g., OpenAI/ChatGPT).
// If you modify this behavior, re-verify compatibility with OpenAI tools.
return z.any();
}
const filterExpression = z.array(z.union([
z.array(z.union([z.string(), z.number(), z.boolean()])).length(3),
z.enum(["and", "or"]),
z.array(z.unknown()).length(3),
z.union([z.string(), z.number(), z.unknown()]),
z.any()
])).max(3);
return filterExpression;
}
validateAndFormatResponse(response) {
console.error(JSON.stringify(response));
if (defaultGlobalToolConfig.fullResponse || this.supportOnlyFullResponse()) {
let data = response;
this.validateResponseFull(data);
let result = data.tasks[0].result;
return this.formatResponse(result);
}
this.validateResponse(response);
return this.formatResponse(response);
}
formatResponse(data) {
const fieldConfig = FieldConfigurationManager.getInstance();
if (fieldConfig.hasConfiguration()) {
const toolName = this.getName();
if (fieldConfig.isToolConfigured(toolName)) {
const fields = fieldConfig.getFieldsForTool(toolName);
if (fields && fields.length > 0) {
data = filterFields(data, parseFieldPaths(fields));
}
}
}
return {
content: [
{
type: "text",
text: JSON.stringify(data, null, 2),
},
],
};
}
formatErrorResponse(error) {
return {
content: [
{
type: "text",
text: `Error: ${this.formatError(error)}`,
},
],
};
}
validateResponse(response) {
if (response.status_code / 100 !== 200) {
throw new Error(`API Error: ${response.status_message} (Code: ${response.status_code})`);
}
}
validateResponseFull(response) {
if (response.status_code / 100 !== 200) {
throw new Error(`API Error: ${response.status_message} (Code: ${response.status_code})`);
}
if (response.tasks.length === 0) {
throw new Error('No tasks in response');
}
const task = response.tasks[0];
if (task.status_code / 100 !== 200) {
throw new Error(`Task Error: ${task.status_message} (Code: ${task.status_code})`);
}
if (response.tasks_error > 0) {
throw new Error(`Tasks Error: ${response.tasks_error} tasks failed`);
}
}
filterResponseFields(response, fields) {
if (!fields || fields.length === 0) {
return response;
}
const fieldPaths = parseFieldPaths(fields);
return filterFields(response, fieldPaths);
}
formatFilters(filters) {
if (!filters)
return null;
if (filters.length === 0) {
return null;
}
return this.removeNested(filters);
}
removeNested(filters) {
for (var i = 0; i < filters.length; i++) {
if (Array.isArray(filters[i]) && filters[i].length == 1 && Array.isArray(filters[i][0])) {
filters[i] = this.removeNested(filters[i][0]);
}
}
return filters;
}
formatOrderBy(orderBy) {
if (!orderBy)
return null;
if (orderBy.length === 0) {
return null;
}
return orderBy;
}
}
//# sourceMappingURL=base.tool.js.map