@ebowwa/crm 0.1.0

package/src/mcp/tools/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Tools module exports
+ */
+
+export { ToolHandlers } from './handlers.js';
+export { TOOL_DEFINITIONS, getToolDefinition, listToolNames } from './definitions.js';
+export type { ToolInput, ToolOutput } from './types.js';

package/src/mcp/tools/types.ts

@@ -0,0 +1,390 @@
+/**
+ * MCP Tool type definitions for CRM
+ */
+
+import type {
+  Contact,
+  Deal,
+  Activity,
+  Media,
+  Note,
+  Tag,
+  Company,
+  ContactFilter,
+  DealFilter,
+  ActivityFilter,
+  PaginationOptions,
+} from '../../core/types.js';
+
+/** Tool input types */
+export interface ToolInput {
+  [key: string]: unknown;
+}
+
+/** Tool output response */
+export interface ToolOutput<T = unknown> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  metadata?: Record<string, unknown>;
+}
+
+// ============================================================================
+// Contact Tool Types
+// ============================================================================
+
+export interface CreateContactInput {
+  name: string;
+  firstName?: string;
+  lastName?: string;
+  emails?: Array<{ email: string; type: string; primary: boolean }>;
+  phones?: Array<{ number: string; type: string; primary: boolean }>;
+  company?: string;
+  title?: string;
+  tags?: string[];
+  source?: string;
+  status?: string;
+  customFields?: Array<{ key: string; value: unknown; type: string }>;
+}
+
+export interface UpdateContactInput {
+  id: string;
+  name?: string;
+  firstName?: string;
+  lastName?: string;
+  emails?: Array<{ email: string; type: string; primary: boolean }>;
+  phones?: Array<{ number: string; type: string; primary: boolean }>;
+  company?: string;
+  title?: string;
+  tags?: string[];
+  status?: string;
+  customFields?: Array<{ key: string; value: unknown; type: string }>;
+}
+
+export interface GetContactInput {
+  id: string;
+}
+
+export interface ListContactsInput extends PaginationOptions, Partial<ContactFilter> {}
+
+export interface DeleteContactInput {
+  id: string;
+}
+
+export interface SearchContactsInput {
+  query: string;
+  limit?: number;
+}
+
+// ============================================================================
+// Deal Tool Types
+// ============================================================================
+
+export interface CreateDealInput {
+  title: string;
+  contactId: string;
+  value: number;
+  currency?: string;
+  stage?: string;
+  probability?: number;
+  expectedClose: string;
+  notes?: string;
+  tags?: string[];
+}
+
+export interface UpdateDealInput {
+  id: string;
+  title?: string;
+  value?: number;
+  stage?: string;
+  probability?: number;
+  expectedClose?: string;
+  notes?: string;
+  tags?: string[];
+}
+
+export interface GetDealInput {
+  id: string;
+}
+
+export interface ListDealsInput extends PaginationOptions, Partial<DealFilter> {}
+
+export interface DeleteDealInput {
+  id: string;
+}
+
+export interface GetDealsByStageInput {
+  stage: string;
+  limit?: number;
+}
+
+// ============================================================================
+// Activity Tool Types
+// ============================================================================
+
+export interface CreateActivityInput {
+  contactId?: string;
+  dealId?: string;
+  type: string;
+  title: string;
+  description?: string;
+  timestamp?: string;
+  duration?: number;
+  metadata?: Record<string, unknown>;
+  tags?: string[];
+}
+
+export interface UpdateActivityInput {
+  id: string;
+  title?: string;
+  description?: string;
+  metadata?: Record<string, unknown>;
+  tags?: string[];
+}
+
+export interface GetActivityInput {
+  id: string;
+}
+
+export interface ListActivitiesInput extends PaginationOptions, Partial<ActivityFilter> {}
+
+export interface DeleteActivityInput {
+  id: string;
+}
+
+// ============================================================================
+// Media Tool Types
+// ============================================================================
+
+export interface CreateMediaInput {
+  entityType: string;
+  entityId: string;
+  type: string;
+  filename: string;
+  mimeType: string;
+  size: number;
+  url: string;
+  metadata?: Record<string, unknown>;
+  altText?: string;
+  caption?: string;
+}
+
+export interface GetMediaInput {
+  id: string;
+}
+
+export interface ListMediaInput {
+  entityType?: string;
+  entityId?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface DeleteMediaInput {
+  id: string;
+}
+
+// ============================================================================
+// Note Tool Types
+// ============================================================================
+
+export interface CreateNoteInput {
+  contactId?: string;
+  dealId?: string;
+  content: string;
+  format?: string;
+  title?: string;
+  visibility?: string;
+  tags?: string[];
+}
+
+export interface UpdateNoteInput {
+  id: string;
+  content?: string;
+  title?: string;
+  visibility?: string;
+  tags?: string[];
+}
+
+export interface GetNoteInput {
+  id: string;
+}
+
+export interface ListNotesInput {
+  contactId?: string;
+  dealId?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface DeleteNoteInput {
+  id: string;
+}
+
+// ============================================================================
+// Tag Tool Types
+// ============================================================================
+
+export interface CreateTagInput {
+  name: string;
+  label: string;
+  color: string;
+  category?: string;
+  description?: string;
+}
+
+export interface UpdateTagInput {
+  id: string;
+  label?: string;
+  color?: string;
+  description?: string;
+}
+
+export interface GetTagInput {
+  id: string;
+}
+
+export interface ListTagsInput {
+  category?: string;
+  limit?: number;
+}
+
+export interface DeleteTagInput {
+  id: string;
+}
+
+// ============================================================================
+// Company Tool Types
+// ============================================================================
+
+export interface CreateCompanyInput {
+  name: string;
+  website?: string;
+  industry?: string;
+  size?: string;
+  tags?: string[];
+}
+
+export interface UpdateCompanyInput {
+  id: string;
+  name?: string;
+  website?: string;
+  industry?: string;
+  size?: string;
+  tags?: string[];
+}
+
+export interface GetCompanyInput {
+  id: string;
+}
+
+export interface ListCompaniesInput extends PaginationOptions {
+  industry?: string;
+}
+
+export interface DeleteCompanyInput {
+  id: string;
+}
+
+// ============================================================================
+// Stats Tool Types
+// ============================================================================
+
+export interface GetStatsInput {}
+
+export interface GetDashboardInput {
+  period?: string;
+}
+
+// ============================================================================
+// Tool Output Types
+// ============================================================================
+
+export interface ContactOutput {
+  contact: Contact;
+}
+
+export interface ContactListOutput {
+  contacts: Contact[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface DealOutput {
+  deal: Deal;
+}
+
+export interface DealListOutput {
+  deals: Deal[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface ActivityOutput {
+  activity: Activity;
+}
+
+export interface ActivityListOutput {
+  activities: Activity[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface MediaOutput {
+  media: Media;
+}
+
+export interface MediaListOutput {
+  media: Media[];
+  total: number;
+}
+
+export interface NoteOutput {
+  note: Note;
+}
+
+export interface NoteListOutput {
+  notes: Note[];
+  total: number;
+}
+
+export interface TagOutput {
+  tag: Tag;
+}
+
+export interface TagListOutput {
+  tags: Tag[];
+  total: number;
+}
+
+export interface CompanyOutput {
+  company: Company;
+}
+
+export interface CompanyListOutput {
+  companies: Company[];
+  total: number;
+  page: number;
+  limit: number;
+}
+
+export interface StatsOutput {
+  contacts: number;
+  deals: number;
+  activities: number;
+  media: number;
+  notes: number;
+  tags: number;
+  companies: number;
+  pipelines: number;
+}
+
+export interface DashboardOutput {
+  stats: StatsOutput;
+  dealsByStage: Record<string, number>;
+  recentActivities: Activity[];
+  upcomingFollowUps: Contact[];
+}

package/src/mcp/transports/stdio.ts

@@ -0,0 +1,225 @@
+/**
+ * STDIO transport for CRM MCP
+ * Handles communication over standard input/output
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { CRMStorageClient } from '../storage/client.js';
+import { ToolHandlers } from '../tools/handlers.js';
+import { TOOL_DEFINITIONS } from '../tools/definitions.js';
+import { CRMError } from '../storage/types.js';
+
+/**
+ * STDIO Server implementation for CRM
+ */
+export class StdioServer {
+  private server: Server;
+  private handlers: ToolHandlers;
+
+  constructor(private storage: CRMStorageClient) {
+    this.server = new Server(
+      {
+        name: 'crm-mcp-server',
+        version: '0.1.0',
+      },
+      {
+        capabilities: {
+          tools: {},
+        },
+      }
+    );
+
+    this.handlers = new ToolHandlers(storage);
+    this.setupHandlers();
+  }
+
+  /**
+   * Set up MCP request handlers
+   */
+  private setupHandlers(): void {
+    // List available tools
+    this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+      return {
+        tools: TOOL_DEFINITIONS,
+      };
+    });
+
+    // Handle tool calls
+    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      const { name, arguments: args } = request.params;
+
+      try {
+        let result;
+
+        // Contact tools
+        if (name === 'crm_create_contact') {
+          result = await this.handlers.createContact(args ?? {});
+        } else if (name === 'crm_get_contact') {
+          result = await this.handlers.getContact(args ?? {});
+        } else if (name === 'crm_update_contact') {
+          result = await this.handlers.updateContact(args ?? {});
+        } else if (name === 'crm_delete_contact') {
+          result = await this.handlers.deleteContact(args ?? {});
+        } else if (name === 'crm_list_contacts') {
+          result = await this.handlers.listContacts(args ?? {});
+        } else if (name === 'crm_search_contacts') {
+          result = await this.handlers.searchContacts(args ?? {});
+        }
+        // Deal tools
+        else if (name === 'crm_create_deal') {
+          result = await this.handlers.createDeal(args ?? {});
+        } else if (name === 'crm_get_deal') {
+          result = await this.handlers.getDeal(args ?? {});
+        } else if (name === 'crm_update_deal') {
+          result = await this.handlers.updateDeal(args ?? {});
+        } else if (name === 'crm_delete_deal') {
+          result = await this.handlers.deleteDeal(args ?? {});
+        } else if (name === 'crm_list_deals') {
+          result = await this.handlers.listDeals(args ?? {});
+        } else if (name === 'crm_get_deals_by_stage') {
+          result = await this.handlers.getDealsByStage(args ?? {});
+        }
+        // Activity tools
+        else if (name === 'crm_create_activity') {
+          result = await this.handlers.createActivity(args ?? {});
+        } else if (name === 'crm_get_activity') {
+          result = await this.handlers.getActivity(args ?? {});
+        } else if (name === 'crm_list_activities') {
+          result = await this.handlers.listActivities(args ?? {});
+        } else if (name === 'crm_delete_activity') {
+          result = await this.handlers.deleteActivity(args ?? {});
+        }
+        // Media tools
+        else if (name === 'crm_upload_media') {
+          result = await this.handlers.uploadMedia(args ?? {});
+        } else if (name === 'crm_get_media') {
+          result = await this.handlers.getMedia(args ?? {});
+        } else if (name === 'crm_list_media') {
+          result = await this.handlers.listMedia(args ?? {});
+        } else if (name === 'crm_delete_media') {
+          result = await this.handlers.deleteMedia(args ?? {});
+        }
+        // Note tools
+        else if (name === 'crm_create_note') {
+          result = await this.handlers.createNote(args ?? {});
+        } else if (name === 'crm_get_note') {
+          result = await this.handlers.getNote(args ?? {});
+        } else if (name === 'crm_update_note') {
+          result = await this.handlers.updateNote(args ?? {});
+        } else if (name === 'crm_delete_note') {
+          result = await this.handlers.deleteNote(args ?? {});
+        } else if (name === 'crm_list_notes') {
+          result = await this.handlers.listNotes(args ?? {});
+        }
+        // Tag tools
+        else if (name === 'crm_create_tag') {
+          result = await this.handlers.createTag(args ?? {});
+        } else if (name === 'crm_get_tag') {
+          result = await this.handlers.getTag(args ?? {});
+        } else if (name === 'crm_list_tags') {
+          result = await this.handlers.listTags(args ?? {});
+        } else if (name === 'crm_delete_tag') {
+          result = await this.handlers.deleteTag(args ?? {});
+        }
+        // Company tools
+        else if (name === 'crm_create_company') {
+          result = await this.handlers.createCompany(args ?? {});
+        } else if (name === 'crm_get_company') {
+          result = await this.handlers.getCompany(args ?? {});
+        } else if (name === 'crm_update_company') {
+          result = await this.handlers.updateCompany(args ?? {});
+        } else if (name === 'crm_delete_company') {
+          result = await this.handlers.deleteCompany(args ?? {});
+        } else if (name === 'crm_list_companies') {
+          result = await this.handlers.listCompanies(args ?? {});
+        }
+        // Stats & Dashboard
+        else if (name === 'crm_get_stats') {
+          result = await this.handlers.getStats();
+        } else if (name === 'crm_get_dashboard') {
+          result = await this.handlers.getDashboard(args ?? {});
+        }
+        // Unknown tool
+        else {
+          return {
+            content: [
+              {
+                type: 'text',
+                text: JSON.stringify({
+                  success: false,
+                  error: `Unknown tool: ${name}`,
+                }),
+              },
+            ],
+          };
+        }
+
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        const errorMessage = error instanceof CRMError ? error.message : String(error);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify({
+                success: false,
+                error: errorMessage,
+              }),
+            },
+          ],
+          isError: true,
+        };
+      }
+    });
+  }
+
+  /**
+   * Start the STDIO server
+   */
+  async start(): Promise<void> {
+    // Set up error handling
+    this.server.onerror = (error) => console.error('[CRM MCP Error]', error);
+
+    // Set up signal handlers for graceful shutdown
+    process.on('SIGINT', async () => {
+      console.error('[CRM MCP] Received SIGINT, shutting down...');
+      await this.server.close();
+      await this.storage.close();
+      process.exit(0);
+    });
+
+    process.on('SIGTERM', async () => {
+      console.error('[CRM MCP] Received SIGTERM, shutting down...');
+      await this.server.close();
+      await this.storage.close();
+      process.exit(0);
+    });
+
+    // Connect the transport
+    const transport = new StdioServerTransport();
+    await this.server.connect(transport);
+
+    // Log startup confirmation to stderr (doesn't interfere with JSON-RPC)
+    console.error('[CRM MCP] Server running on stdio');
+
+    // Keep stdin open to receive requests
+    process.stdin.resume();
+  }
+
+  /**
+   * Stop the server
+   */
+  async stop(): Promise<void> {
+    await this.server.close();
+    await this.storage.close();
+  }
+}