@mseep/atlas-mcp-server
Version:
A Model Context Protocol (MCP) server for ATLAS, a Neo4j-powered task management system for LLM Agents - implementing a three-tier architecture (Projects, Tasks, Knowledge) to manage complex workflows.
117 lines (116 loc) • 5.28 kB
JavaScript
import { createFormattedResponse } from "../../../utils/responseFormatter.js";
/**
* Formatter for single project creation responses
*/
export class SingleProjectFormatter {
format(data) {
// Extract project properties from Neo4j structure
const projectData = data.properties || data;
const { name, id, status, taskType, createdAt } = projectData;
// Create a summary section
const summary = `Project Created Successfully\n\n` +
`Project: ${name || 'Unnamed Project'}\n` +
`ID: ${id || 'Unknown ID'}\n` +
`Status: ${status || 'Unknown Status'}\n` +
`Type: ${taskType || 'Unknown Type'}\n` +
`Created: ${createdAt ? new Date(createdAt).toLocaleString() : 'Unknown Date'}\n`;
// Create a comprehensive details section with all project properties
const fieldLabels = {
id: "ID",
name: "Name",
description: "Description",
status: "Status",
urls: "URLs",
completionRequirements: "Completion Requirements",
outputFormat: "Output Format",
taskType: "Task Type",
createdAt: "Created At",
updatedAt: "Updated At"
};
let details = `Project Details\n\n`;
// Build details as key-value pairs
Object.entries(fieldLabels).forEach(([key, label]) => {
if (projectData[key] !== undefined) {
let value = projectData[key];
// Format arrays
if (Array.isArray(value)) {
value = value.length > 0 ? JSON.stringify(value) : "None";
}
// Format objects
else if (typeof value === "object" && value !== null) {
value = JSON.stringify(value);
}
// Format dates more readably if they look like ISO dates
else if (typeof value === "string" &&
/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value)) {
try {
value = new Date(value).toLocaleString();
}
catch (e) {
// Keep original if parsing fails
}
}
details += `${label}: ${value}\n`;
}
});
return `${summary}\n\n${details}`;
}
}
/**
* Formatter for bulk project creation responses
*/
export class BulkProjectFormatter {
format(data) {
const { success, message, created, errors } = data;
// Create a summary section with operation results
const summary = `${success ? "Projects Created Successfully" : "Project Creation Completed with Errors"}\n\n` +
`Status: ${success ? "✅ Success" : "⚠️ Partial Success"}\n` +
`Summary: ${message}\n` +
`Created: ${created.length} project(s)\n` +
`Errors: ${errors.length} error(s)\n`;
// List the successfully created projects
let createdSection = "";
if (created.length > 0) {
createdSection = `Created Projects\n\n`;
createdSection += created.map((project, index) => {
// Extract project properties from Neo4j structure
const projectData = project.properties || project;
return `${index + 1}. ${projectData.name || 'Unnamed Project'}\n\n` +
`ID: ${projectData.id || 'Unknown ID'}\n` +
`Type: ${projectData.taskType || 'Unknown Type'}\n` +
`Status: ${projectData.status || 'Unknown Status'}\n` +
`Created: ${projectData.createdAt ? new Date(projectData.createdAt).toLocaleString() : 'Unknown Date'}\n`;
}).join("\n\n");
}
// List any errors that occurred
let errorsSection = "";
if (errors.length > 0) {
errorsSection = `Errors\n\n`;
errorsSection += errors.map((error, index) => {
const projectName = error.project?.name || `Project at index ${error.index}`;
return `${index + 1}. Error in "${projectName}"\n\n` +
`Error Code: ${error.error.code}\n` +
`Message: ${error.error.message}\n` +
(error.error.details ? `Details: ${JSON.stringify(error.error.details)}\n` : "");
}).join("\n\n");
}
return `${summary}\n\n${createdSection}\n\n${errorsSection}`.trim();
}
}
/**
* Create a formatted, human-readable response for the atlas_project_create tool
*
* @param data The raw project creation response data
* @param isError Whether this response represents an error condition
* @returns Formatted MCP tool response with appropriate structure
*/
export function formatProjectCreateResponse(data, isError = false) {
// Determine if this is a single or bulk project response
const isBulkResponse = data.hasOwnProperty("success") && data.hasOwnProperty("created");
if (isBulkResponse) {
return createFormattedResponse(data, new BulkProjectFormatter(), isError);
}
else {
return createFormattedResponse(data, new SingleProjectFormatter(), isError);
}
}