aindreyway-mcp-codex-keeper
Version:
An intelligent MCP server that serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices
94 lines (93 loc) • 2.77 kB
TypeScript
/**
* Categories for organizing documentation
* @description Defines all available documentation categories
*/
export type DocCategory = 'Frontend' | 'Backend' | 'Language' | 'MCP' | 'MCP-Guide' | 'Database' | 'DevOps' | 'Security' | 'Testing' | 'Architecture' | 'Mobile' | 'AI' | 'Cloud';
/**
* Documentation source structure
* @description Represents a documentation source with metadata
*/
export interface DocSource {
/** Unique name of the documentation source */
name: string;
/** URL where the documentation can be found */
url: string;
/** Description of what this documentation covers */
description: string;
/** Category this documentation belongs to */
category: DocCategory;
/** ISO timestamp of last update */
lastUpdated?: string;
/** Optional tags for additional categorization */
tags?: string[];
/** Optional version information */
version?: string;
}
/**
* Arguments for listing documentation
* @description Parameters for filtering documentation lists
*/
export interface ListDocsArgs {
/** Optional category filter */
category?: DocCategory;
/** Optional tag filter */
tag?: string;
}
/**
* Arguments for adding new documentation
* @description Required and optional fields for adding documentation
*/
export interface AddDocArgs {
/** Unique name for the documentation */
name: string;
/** URL where the documentation can be found */
url: string;
/** Description of what this documentation covers */
description: string;
/** Category this documentation belongs to */
category: DocCategory;
/** Optional tags for additional categorization */
tags?: string[];
/** Optional version information */
version?: string;
}
/**
* Arguments for updating documentation
* @description Parameters for updating existing documentation
*/
export interface UpdateDocArgs {
/** Name of the documentation to update */
name: string;
/** Optional force flag to overwrite cache */
force?: boolean;
}
/**
* Arguments for searching documentation
* @description Search parameters and filters
*/
export interface SearchDocArgs {
/** Search query string */
query: string;
/** Optional category filter */
category?: DocCategory;
/** Optional tag filter */
tag?: string;
}
/**
* Custom error for duplicate documentation
*/
export declare class DocAlreadyExistsError extends Error {
constructor(name: string);
}
/**
* Custom error for missing documentation
*/
export declare class DocNotFoundError extends Error {
constructor(name: string);
}
/**
* Custom error for invalid documentation URL
*/
export declare class InvalidDocUrlError extends Error {
constructor(url: string);
}