@aashari/mcp-server-atlassian-confluence
Version:
Node.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces & pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP in
79 lines (78 loc) • 2.35 kB
TypeScript
/**
* Error types for classification
*/
export declare enum ErrorType {
AUTH_MISSING = "AUTH_MISSING",
AUTH_INVALID = "AUTH_INVALID",
API_ERROR = "API_ERROR",
NOT_FOUND = "NOT_FOUND",
UNEXPECTED_ERROR = "UNEXPECTED_ERROR"
}
/**
* Custom error class with type classification
*/
export declare class McpError extends Error {
type: ErrorType;
statusCode?: number;
originalError?: unknown;
constructor(message: string, type: ErrorType, statusCode?: number, originalError?: unknown);
}
/**
* Helper to unwrap nested McpErrors and return the deepest original error.
* This is useful when an McpError contains another McpError as `originalError`
* which in turn may wrap the vendor (Confluence) error text or object.
*/
export declare function getDeepOriginalError(error: unknown): unknown;
/**
* Create an authentication missing error
*/
export declare function createAuthMissingError(message?: string, originalError?: unknown): McpError;
/**
* Create an authentication invalid error
*/
export declare function createAuthInvalidError(message?: string, originalError?: unknown): McpError;
/**
* Create an API error
*/
export declare function createApiError(message: string, statusCode?: number, originalError?: unknown): McpError;
/**
* Create a not found error
*/
export declare function createNotFoundError(message?: string, originalError?: unknown): McpError;
/**
* Create an unexpected error
*/
export declare function createUnexpectedError(message?: string, originalError?: unknown): McpError;
/**
* Ensure an error is an McpError
*/
export declare function ensureMcpError(error: unknown): McpError;
/**
* Format error for MCP tool response
*/
export declare function formatErrorForMcpTool(error: unknown): {
content: Array<{
type: 'text';
text: string;
}>;
metadata?: {
errorType: ErrorType;
statusCode?: number;
errorDetails?: unknown;
};
};
/**
* Format error for MCP resource response
*/
export declare function formatErrorForMcpResource(error: unknown, uri: string): {
contents: Array<{
uri: string;
text: string;
mimeType: string;
description?: string;
}>;
};
/**
* Handle error in CLI context with improved user feedback
*/
export declare function handleCliError(error: unknown): never;