@carbonvoice/cv-mcp-server 1.0.10 → 1.0.12

package/dist/generated/carbon-voice-api/CarbonVoiceSimplifiedAPI.zod.js

@@ -640,7 +640,8 @@ exports.listMessagesResponse = zod_1.z.object({
         "conversation_id": zod_1.z.string().optional().describe('Conversation ID (optional)'),
         "language": zod_1.z.string().optional().describe('Language (optional)'),
         "type": zod_1.z.enum(['channel', 'prerecorded', 'voicememo', 'stored', 'welcome']).optional().describe('Type (optional)'),
-        "folder_id": zod_1.z.string().optional().describe('Folder ID (optional)')
+        "folder_id": zod_1.z.string().optional().describe('Folder ID (optional)'),
+        "user_ids": zod_1.z.array(zod_1.z.string()).optional().describe('User IDs (optional). List of user IDs to filter messages by. If not provided, all users will be included.')
     }).optional().describe('Filters'),
     "results": zod_1.z.array(zod_1.z.object({
         "id": zod_1.z.string().describe('ID'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carbonvoice/cv-mcp-server",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Server implementation for integrating with Carbon Voice's API, providing tools and endpoints for voice messaging, conversations, and workspace management through MCP (Model Context Protocol)",
   "author": "Carbon Voice",
   "license": "ISC",

package/readme.md

@@ -0,0 +1,198 @@
+# Carbon Voice MCP Server
+
+A Model Context Protocol (MCP) server implementation for integrating with Carbon Voice's API, providing AI assistants with comprehensive tools for voice messaging, conversations, and workspace management.
+
+## Features
+
+- **Message Management**: Create, list, and retrieve voice messages, conversation messages, and direct messages
+- **User Operations**: Search and retrieve user information
+- **Conversation Management**: Access and manage conversations and their participants
+- **Folder Operations**: Create, organize, move, and manage folders and their contents
+- **Workspace Administration**: Get workspace information
+- **AI Actions**: Run AI prompts and retrieve AI-generated responses
+- **Attachment Support**: Add link attachments to messages
+
+## Prerequisites
+
+### API Key Required
+
+To use this MCP server, you need a Carbon Voice API key. Please contact the Carbon Voice development team to request your API key:
+
+**📧 Contact**: devsupport@phononx.com
+
+## Configuration
+
+### For Cursor
+
+1. Open Cursor
+2. Go to **Cursor Settings** > **Features** > **Model Context Protocol**
+3. Add a new MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "Carbon-Voice": {
+      "command": "npx",
+      "env": {
+        "CARBON_VOICE_API_KEY": "your_api_key_here"
+      },
+      "args": ["-y", "@carbonvoice/cv-mcp-server"]
+    }
+  }
+}
+```
+
+4. Replace `"your_api_key_here"` with your actual Carbon Voice API key
+5. Save and restart Cursor
+
+### For Claude Desktop
+
+1. Open your Claude Desktop configuration file:
+
+   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+2. Add the Carbon Voice MCP server configuration:
+
+```json
+{
+  "mcpServers": {
+    "Carbon-Voice": {
+      "command": "npx",
+      "env": {
+        "CARBON_VOICE_API_KEY": "your_api_key_here"
+      },
+      "args": ["-y", "@carbonvoice/cv-mcp-server"]
+    }
+  }
+}
+```
+
+3. Replace `"your_api_key_here"` with your actual Carbon Voice API key
+4. Save the file and restart Claude Desktop
+
+## Available Tools
+
+### Messages
+
+- **`list_messages`** - List messages with date filtering (max 31-day range)
+- **`get_message`** - Retrieve a specific message by ID
+- **`get_recent_messages`** - Get the 10 most recent messages with full context
+- **`create_conversation_message`** - Send a message to a conversation
+- **`create_direct_message`** - Send direct messages to users or groups
+- **`create_voicememo_message`** - Create voice memo messages
+- **`add_attachments_to_message`** - Add link attachments to existing messages
+
+### Users
+
+- **`get_user`** - Retrieve user information by ID
+- **`search_user`** - Find a user by phone number or email
+- **`search_users`** - Search multiple users by various identifiers
+
+### Conversations
+
+- **`list_conversations`** - Get all conversations from the last 6 months
+- **`get_conversation`** - Retrieve conversation details by ID
+- **`get_conversation_users`** - Get all users in a conversation
+
+### Folders
+
+- **`get_workspace_folders_and_message_counts`** - Get folder and message statistics
+- **`get_root_folders`** - List root folders for a workspace
+- **`create_folder`** - Create new folders
+- **`get_folder`** - Retrieve folder information
+- **`get_folder_with_messages`** - Get folder with its messages
+- **`update_folder_name`** - Rename folders
+- **`delete_folder`** - Delete folders (⚠️ destructive operation)
+- **`move_folder`** - Move folders between locations
+- **`move_message_to_folder`** - Organize messages into folders
+
+### Workspace
+
+- **`get_workspaces_basic_info`** - Get basic workspace information
+
+### AI Actions
+
+- **`list_ai_actions`** - List available AI prompts/actions
+- **`run_ai_action`** - Execute AI actions on messages
+- **`run_ai_action_for_shared_link`** - Run AI actions on shared content
+- **`get_ai_action_responses`** - Retrieve AI-generated responses
+
+## Usage Examples
+
+### Getting Started
+
+After configuration, you can interact with Carbon Voice through your AI assistant. Here are some example requests:
+
+```
+"Show me my recent messages"
+"Create a voice memo about today's meeting"
+"Search for user john@example.com"
+"Show me my workspace information"
+"List my conversations from this week"
+```
+
+### Working with Folders
+
+```
+"Create a folder called 'Project Updates'"
+"Move message ID 12345 to the Project Updates folder"
+"Show me all messages in the Marketing folder"
+```
+
+### AI Actions
+
+```
+"Run a summary AI action on message ID 67890"
+"List all available AI prompts"
+"Get AI responses for conversation ID 123"
+```
+
+## Error Handling
+
+The server includes comprehensive error handling and logging. Errors are returned in a structured format that includes:
+
+- Error messages
+- HTTP status codes
+- Request context
+- Debugging information
+
+## Development
+
+### Building from Source
+
+```bash
+npm run build
+```
+
+### Running in Development Mode
+
+```bash
+npm run auto:build  # Watch mode with auto-rebuild
+```
+
+### Linting
+
+```bash
+npm run lint:fix
+```
+
+### Testing with MCP Inspector
+
+```bash
+npm run mcp:inspector
+```
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/PhononX/cv-mcp-server/issues)
+- **API Key Requests**: devsupport@phononx.com
+- **Website**: [https://getcarbon.app](https://getcarbon.app)
+
+## License
+
+ISC License - See LICENSE file for details.
+
+---
+
+**Note**: This MCP server requires a valid Carbon Voice API key to function. Please ensure you have obtained your API key from the Carbon Voice team before attempting to use the server.

package/dist/bootstrap.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-require("@dotenvx/dotenvx/config");

package/dist/carbon-voice.js

@@ -1,20 +0,0 @@
-"use strict";
-// export class CarbonVoiceClient {
-//   private static instance: CarbonVoiceClient;
-Object.defineProperty(exports, "__esModule", { value: true });
-//   static getInstance() {
-//     if (!CarbonVoiceClient.instance) {
-//       CarbonVoiceClient.instance = new CarbonVoiceClient();
-//     }
-//     return CarbonVoiceClient.instance;
-//   }
-//   async listAllConversations(): Promise<any> {
-//     try {
-//       // const response = await getAllConversations();
-//       return {} as any;
-//     } catch (error) {
-//       // console.error('Error listing all conversations:', error);
-//       return error;
-//     }
-//   }
-// }

package/dist/index-v1.js

@@ -1,80 +0,0 @@
-"use strict";
-// #!/usr/bin/env node
-// import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-// import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-// import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-// import {
-//   CallToolRequest,
-//   CallToolRequestSchema,
-//   ListToolsRequestSchema,
-//   Tool,
-// } from '@modelcontextprotocol/sdk/types.js';
-// import { z } from 'zod';
-// import { CarbonVoiceClient } from './carbon-voice.js';
-Object.defineProperty(exports, "__esModule", { value: true });
-// /**
-//  * Environment variables
-//  */
-// const CV_API_BASE_URL = 'https://wf5whhzd-8081.brs.devtunnels.ms';
-// const CV_API_SIMPLIFIED_BASE_URL = `${CV_API_BASE_URL}/simplified`;
-// const USER_AGENT = 'carbonvoice-app/1.0';
-// // Type definitions for tool arguments
-// interface ListConversationArgs {
-//   limit?: number;
-//   cursor?: string;
-// }
-// const apiKey = process.env.CARBON_VOICE_API_KEY;
-// if (!apiKey) {
-//   console.error('Please set CARBON_VOICE_API_KEY environment variable');
-//   process.exit(1);
-// }
-// // Carbon Voice Client
-// const client = new CarbonVoiceClient(apiKey);
-// console.error('Starting Carbon Voice MCP Server...');
-// // Create server instance
-// const server = new McpServer({
-//   name: 'Carbon Voice MCP Server',
-//   version: '1.0.0',
-//   capabilities: {
-//     resources: {},
-//     tools: {},
-//   },
-// });
-// server.tool(
-//   'list_all_conversations',
-//   'List all conversations',
-//   {
-//     workspace_id: z.string().optional().describe('Carbon Voice workspace ID'),
-//   },
-//   async ({ workspace_id }) => {
-//     const channelsData = await client.listAllConversations();
-//     if (!channelsData) {
-//       return {
-//         content: [
-//           {
-//             type: 'text',
-//             text: 'Failed to retrieve all conversations',
-//           },
-//         ],
-//       };
-//     }
-//     return {
-//       content: [
-//         {
-//           type: 'text',
-//           text: JSON.stringify(channelsData),
-//         },
-//       ],
-//     };
-//   },
-// );
-// async function runServer() {
-//   const transport = new StdioServerTransport();
-//   console.error('Connecting server to transport...');
-//   await server.connect(transport);
-//   console.error('Carbon Voice MCP Server running on stdio');
-// }
-// runServer().catch((error) => {
-//   console.error('Fatal error in runServer():', error);
-//   process.exit(1);
-// });

package/dist/server-delete.js

@@ -1,624 +0,0 @@
-"use strict";
-// import { z } from 'zod';
-// import { zodToJsonSchema } from 'zod-to-json-schema';
-Object.defineProperty(exports, "__esModule", { value: true });
-// import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-// import {
-//   CallToolRequestSchema,
-//   CompleteRequestSchema,
-//   CreateMessageRequest,
-//   CreateMessageResultSchema,
-//   GetPromptRequestSchema,
-//   ListPromptsRequestSchema,
-//   ListResourcesRequestSchema,
-//   ListResourceTemplatesRequestSchema,
-//   ListToolsRequestSchema,
-//   LoggingLevel,
-//   ReadResourceRequestSchema,
-//   Resource,
-//   SetLevelRequestSchema,
-//   SubscribeRequestSchema,
-//   Tool,
-//   ToolSchema,
-//   UnsubscribeRequestSchema,
-// } from '@modelcontextprotocol/sdk/types.js';
-// const ToolInputSchema = ToolSchema.shape.inputSchema;
-// type ToolInput = z.infer<typeof ToolInputSchema>;
-// /* Input schemas for tools implemented in this server */
-// const EchoSchema = z.object({
-//   message: z.string().describe('Message to echo'),
-// });
-// const AddSchema = z.object({
-//   a: z.number().describe('First number'),
-//   b: z.number().describe('Second number'),
-// });
-// const LongRunningOperationSchema = z.object({
-//   duration: z
-//     .number()
-//     .default(10)
-//     .describe('Duration of the operation in seconds'),
-//   steps: z.number().default(5).describe('Number of steps in the operation'),
-// });
-// const PrintEnvSchema = z.object({});
-// const SampleLLMSchema = z.object({
-//   prompt: z.string().describe('The prompt to send to the LLM'),
-//   maxTokens: z
-//     .number()
-//     .default(100)
-//     .describe('Maximum number of tokens to generate'),
-// });
-// // Example completion values
-// const EXAMPLE_COMPLETIONS = {
-//   style: ['casual', 'formal', 'technical', 'friendly'],
-//   temperature: ['0', '0.5', '0.7', '1.0'],
-//   resourceId: ['1', '2', '3', '4', '5'],
-// };
-// const GetTinyImageSchema = z.object({});
-// const AnnotatedMessageSchema = z.object({
-//   messageType: z
-//     .enum(['error', 'success', 'debug'])
-//     .describe('Type of message to demonstrate different annotation patterns'),
-//   includeImage: z
-//     .boolean()
-//     .default(false)
-//     .describe('Whether to include an example image'),
-// });
-// const GetResourceReferenceSchema = z.object({
-//   resourceId: z
-//     .number()
-//     .min(1)
-//     .max(100)
-//     .describe('ID of the resource to reference (1-100)'),
-// });
-// enum ToolName {
-//   ECHO = 'echo',
-//   ADD = 'add',
-//   LONG_RUNNING_OPERATION = 'longRunningOperation',
-//   PRINT_ENV = 'printEnv',
-//   SAMPLE_LLM = 'sampleLLM',
-//   GET_TINY_IMAGE = 'getTinyImage',
-//   ANNOTATED_MESSAGE = 'annotatedMessage',
-//   GET_RESOURCE_REFERENCE = 'getResourceReference',
-// }
-// enum PromptName {
-//   SIMPLE = 'simple_prompt',
-//   COMPLEX = 'complex_prompt',
-//   RESOURCE = 'resource_prompt',
-// }
-// export const createServer = () => {
-//   const server = new Server(
-//     {
-//       name: 'example-servers/everything',
-//       version: '1.0.0',
-//     },
-//     {
-//       capabilities: {
-//         prompts: {},
-//         resources: { subscribe: true },
-//         tools: {},
-//         logging: {},
-//         completions: {},
-//       },
-//     },
-//   );
-//   const subscriptions: Set<string> = new Set();
-//   let subsUpdateInterval: NodeJS.Timeout | undefined;
-//   let stdErrUpdateInterval: NodeJS.Timeout | undefined;
-//   // Set up update interval for subscribed resources
-//   subsUpdateInterval = setInterval(() => {
-//     for (const uri of subscriptions) {
-//       server.notification({
-//         method: 'notifications/resources/updated',
-//         params: { uri },
-//       });
-//     }
-//   }, 10000);
-//   let logLevel: LoggingLevel = 'debug';
-//   let logsUpdateInterval: NodeJS.Timeout | undefined;
-//   const messages = [
-//     { level: 'debug', data: 'Debug-level message' },
-//     { level: 'info', data: 'Info-level message' },
-//     { level: 'notice', data: 'Notice-level message' },
-//     { level: 'warning', data: 'Warning-level message' },
-//     { level: 'error', data: 'Error-level message' },
-//     { level: 'critical', data: 'Critical-level message' },
-//     { level: 'alert', data: 'Alert level-message' },
-//     { level: 'emergency', data: 'Emergency-level message' },
-//   ];
-//   const isMessageIgnored = (level: LoggingLevel): boolean => {
-//     const currentLevel = messages.findIndex((msg) => logLevel === msg.level);
-//     const messageLevel = messages.findIndex((msg) => level === msg.level);
-//     return messageLevel < currentLevel;
-//   };
-//   // Set up update interval for random log messages
-//   logsUpdateInterval = setInterval(() => {
-//     const message = {
-//       method: 'notifications/message',
-//       params: messages[Math.floor(Math.random() * messages.length)],
-//     };
-//     if (!isMessageIgnored(message.params.level as LoggingLevel))
-//       server.notification(message);
-//   }, 20000);
-//   // Set up update interval for stderr messages
-//   stdErrUpdateInterval = setInterval(() => {
-//     const shortTimestamp = new Date().toLocaleTimeString([], {
-//       hour: '2-digit',
-//       minute: '2-digit',
-//       second: '2-digit',
-//     });
-//     server.notification({
-//       method: 'notifications/stderr',
-//       params: { content: `${shortTimestamp}: A stderr message` },
-//     });
-//   }, 30000);
-//   // Helper method to request sampling from client
-//   const requestSampling = async (
-//     context: string,
-//     uri: string,
-//     maxTokens: number = 100,
-//   ) => {
-//     const request: CreateMessageRequest = {
-//       method: 'sampling/createMessage',
-//       params: {
-//         messages: [
-//           {
-//             role: 'user',
-//             content: {
-//               type: 'text',
-//               text: `Resource ${uri} context: ${context}`,
-//             },
-//           },
-//         ],
-//         systemPrompt: 'You are a helpful test server.',
-//         maxTokens,
-//         temperature: 0.7,
-//         includeContext: 'thisServer',
-//       },
-//     };
-//     return await server.request(request, CreateMessageResultSchema);
-//   };
-//   const ALL_RESOURCES: Resource[] = Array.from({ length: 100 }, (_, i) => {
-//     const uri = `test://static/resource/${i + 1}`;
-//     if (i % 2 === 0) {
-//       return {
-//         uri,
-//         name: `Resource ${i + 1}`,
-//         mimeType: 'text/plain',
-//         text: `Resource ${i + 1}: This is a plaintext resource`,
-//       };
-//     } else {
-//       const buffer = Buffer.from(`Resource ${i + 1}: This is a base64 blob`);
-//       return {
-//         uri,
-//         name: `Resource ${i + 1}`,
-//         mimeType: 'application/octet-stream',
-//         blob: buffer.toString('base64'),
-//       };
-//     }
-//   });
-//   const PAGE_SIZE = 10;
-//   server.setRequestHandler(ListResourcesRequestSchema, async (request) => {
-//     const cursor = request.params?.cursor;
-//     let startIndex = 0;
-//     if (cursor) {
-//       const decodedCursor = parseInt(atob(cursor), 10);
-//       if (!isNaN(decodedCursor)) {
-//         startIndex = decodedCursor;
-//       }
-//     }
-//     const endIndex = Math.min(startIndex + PAGE_SIZE, ALL_RESOURCES.length);
-//     const resources = ALL_RESOURCES.slice(startIndex, endIndex);
-//     let nextCursor: string | undefined;
-//     if (endIndex < ALL_RESOURCES.length) {
-//       nextCursor = btoa(endIndex.toString());
-//     }
-//     return {
-//       resources,
-//       nextCursor,
-//     };
-//   });
-//   server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => {
-//     return {
-//       resourceTemplates: [
-//         {
-//           uriTemplate: 'test://static/resource/{id}',
-//           name: 'Static Resource',
-//           description: 'A static resource with a numeric ID',
-//         },
-//       ],
-//     };
-//   });
-//   server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-//     const uri = request.params.uri;
-//     if (uri.startsWith('test://static/resource/')) {
-//       const index = parseInt(uri.split('/').pop() ?? '', 10) - 1;
-//       if (index >= 0 && index < ALL_RESOURCES.length) {
-//         const resource = ALL_RESOURCES[index];
-//         return {
-//           contents: [resource],
-//         };
-//       }
-//     }
-//     throw new Error(`Unknown resource: ${uri}`);
-//   });
-//   server.setRequestHandler(SubscribeRequestSchema, async (request) => {
-//     const { uri } = request.params;
-//     subscriptions.add(uri);
-//     // Request sampling from client when someone subscribes
-//     await requestSampling('A new subscription was started', uri);
-//     return {};
-//   });
-//   server.setRequestHandler(UnsubscribeRequestSchema, async (request) => {
-//     subscriptions.delete(request.params.uri);
-//     return {};
-//   });
-//   server.setRequestHandler(ListPromptsRequestSchema, async () => {
-//     return {
-//       prompts: [
-//         {
-//           name: PromptName.SIMPLE,
-//           description: 'A prompt without arguments',
-//         },
-//         {
-//           name: PromptName.COMPLEX,
-//           description: 'A prompt with arguments',
-//           arguments: [
-//             {
-//               name: 'temperature',
-//               description: 'Temperature setting',
-//               required: true,
-//             },
-//             {
-//               name: 'style',
-//               description: 'Output style',
-//               required: false,
-//             },
-//           ],
-//         },
-//         {
-//           name: PromptName.RESOURCE,
-//           description: 'A prompt that includes an embedded resource reference',
-//           arguments: [
-//             {
-//               name: 'resourceId',
-//               description: 'Resource ID to include (1-100)',
-//               required: true,
-//             },
-//           ],
-//         },
-//       ],
-//     };
-//   });
-//   server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-//     const { name, arguments: args } = request.params;
-//     if (name === PromptName.SIMPLE) {
-//       return {
-//         messages: [
-//           {
-//             role: 'user',
-//             content: {
-//               type: 'text',
-//               text: 'This is a simple prompt without arguments.',
-//             },
-//           },
-//         ],
-//       };
-//     }
-//     if (name === PromptName.COMPLEX) {
-//       return {
-//         messages: [
-//           {
-//             role: 'user',
-//             content: {
-//               type: 'text',
-//               text: `This is a complex prompt with arguments: temperature=${args?.temperature}, style=${args?.style}`,
-//             },
-//           },
-//           {
-//             role: 'assistant',
-//             content: {
-//               type: 'text',
-//               text: "I understand. You've provided a complex prompt with temperature and style arguments.
-// How would you like me to proceed?",
-//             },
-//           },
-//           {
-//             role: 'user',
-//             content: {
-//               type: 'image',
-//               data: MCP_TINY_IMAGE,
-//               mimeType: 'image/png',
-//             },
-//           },
-//         ],
-//       };
-//     }
-//     if (name === PromptName.RESOURCE) {
-//       const resourceId = parseInt(args?.resourceId as string, 10);
-//       if (isNaN(resourceId) || resourceId < 1 || resourceId > 100) {
-//         throw new Error(
-//           `Invalid resourceId: ${args?.resourceId}. Must be a number between 1 and 100.`,
-//         );
-//       }
-//       const resourceIndex = resourceId - 1;
-//       const resource = ALL_RESOURCES[resourceIndex];
-//       return {
-//         messages: [
-//           {
-//             role: 'user',
-//             content: {
-//               type: 'text',
-//               text: `This prompt includes Resource ${resourceId}. Please analyze the following resource:`,
-//             },
-//           },
-//           {
-//             role: 'user',
-//             content: {
-//               type: 'resource',
-//               resource: resource,
-//             },
-//           },
-//         ],
-//       };
-//     }
-//     throw new Error(`Unknown prompt: ${name}`);
-//   });
-//   server.setRequestHandler(ListToolsRequestSchema, async () => {
-//     const tools: Tool[] = [
-//       {
-//         name: ToolName.ECHO,
-//         description: 'Echoes back the input',
-//         inputSchema: zodToJsonSchema(EchoSchema) as ToolInput,
-//       },
-//       {
-//         name: ToolName.ADD,
-//         description: 'Adds two numbers',
-//         inputSchema: zodToJsonSchema(AddSchema) as ToolInput,
-//       },
-//       {
-//         name: ToolName.PRINT_ENV,
-//         description:
-//           'Prints all environment variables, helpful for debugging MCP server configuration',
-//         inputSchema: zodToJsonSchema(PrintEnvSchema) as ToolInput,
-//       },
-//       {
-//         name: ToolName.LONG_RUNNING_OPERATION,
-//         description:
-//           'Demonstrates a long running operation with progress updates',
-//         inputSchema: zodToJsonSchema(LongRunningOperationSchema) as ToolInput,
-//       },
-//       {
-//         name: ToolName.SAMPLE_LLM,
-//         description: "Samples from an LLM using MCP's sampling feature",
-//         inputSchema: zodToJsonSchema(SampleLLMSchema) as ToolInput,
-//       },
-//       {
-//         name: ToolName.GET_TINY_IMAGE,
-//         description: 'Returns the MCP_TINY_IMAGE',
-//         inputSchema: zodToJsonSchema(GetTinyImageSchema) as ToolInput,
-//       },
-//       {
-//         name: ToolName.ANNOTATED_MESSAGE,
-//         description:
-//           'Demonstrates how annotations can be used to provide metadata about content',
-//         inputSchema: zodToJsonSchema(AnnotatedMessageSchema) as ToolInput,
-//       },
-//       {
-//         name: ToolName.GET_RESOURCE_REFERENCE,
-//         description:
-//           'Returns a resource reference that can be used by MCP clients',
-//         inputSchema: zodToJsonSchema(GetResourceReferenceSchema) as ToolInput,
-//       },
-//     ];
-//     return { tools };
-//   });
-//   server.setRequestHandler(CallToolRequestSchema, async (request) => {
-//     const { name, arguments: args } = request.params;
-//     if (name === ToolName.ECHO) {
-//       const validatedArgs = EchoSchema.parse(args);
-//       return {
-//         content: [{ type: 'text', text: `Echo: ${validatedArgs.message}` }],
-//       };
-//     }
-//     if (name === ToolName.ADD) {
-//       const validatedArgs = AddSchema.parse(args);
-//       const sum = validatedArgs.a + validatedArgs.b;
-//       return {
-//         content: [
-//           {
-//             type: 'text',
-//             text: `The sum of ${validatedArgs.a} and ${validatedArgs.b} is ${sum}.`,
-//           },
-//         ],
-//       };
-//     }
-//     if (name === ToolName.LONG_RUNNING_OPERATION) {
-//       const validatedArgs = LongRunningOperationSchema.parse(args);
-//       const { duration, steps } = validatedArgs;
-//       const stepDuration = duration / steps;
-//       const progressToken = request.params._meta?.progressToken;
-//       for (let i = 1; i < steps + 1; i++) {
-//         await new Promise((resolve) =>
-//           setTimeout(resolve, stepDuration * 1000),
-//         );
-//         if (progressToken !== undefined) {
-//           await server.notification({
-//             method: 'notifications/progress',
-//             params: {
-//               progress: i,
-//               total: steps,
-//               progressToken,
-//             },
-//           });
-//         }
-//       }
-//       return {
-//         content: [
-//           {
-//             type: 'text',
-//             text: `Long running operation completed. Duration: ${duration} seconds, Steps: ${steps}.`,
-//           },
-//         ],
-//       };
-//     }
-//     if (name === ToolName.PRINT_ENV) {
-//       return {
-//         content: [
-//           {
-//             type: 'text',
-//             text: JSON.stringify(process.env, null, 2),
-//           },
-//         ],
-//       };
-//     }
-//     if (name === ToolName.SAMPLE_LLM) {
-//       const validatedArgs = SampleLLMSchema.parse(args);
-//       const { prompt, maxTokens } = validatedArgs;
-//       const result = await requestSampling(
-//         prompt,
-//         ToolName.SAMPLE_LLM,
-//         maxTokens,
-//       );
-//       return {
-//         content: [
-//           { type: 'text', text: `LLM sampling result: ${result.content.text}` },
-//         ],
-//       };
-//     }
-//     if (name === ToolName.GET_TINY_IMAGE) {
-//       GetTinyImageSchema.parse(args);
-//       return {
-//         content: [
-//           {
-//             type: 'text',
-//             text: 'This is a tiny image:',
-//           },
-//           {
-//             type: 'image',
-//             data: MCP_TINY_IMAGE,
-//             mimeType: 'image/png',
-//           },
-//           {
-//             type: 'text',
-//             text: 'The image above is the MCP tiny image.',
-//           },
-//         ],
-//       };
-//     }
-//     if (name === ToolName.GET_RESOURCE_REFERENCE) {
-//       const validatedArgs = GetResourceReferenceSchema.parse(args);
-//       const resourceId = validatedArgs.resourceId;
-//       const resourceIndex = resourceId - 1;
-//       if (resourceIndex < 0 || resourceIndex >= ALL_RESOURCES.length) {
-//         throw new Error(`Resource with ID ${resourceId} does not exist`);
-//       }
-//       const resource = ALL_RESOURCES[resourceIndex];
-//       return {
-//         content: [
-//           {
-//             type: 'text',
-//             text: `Returning resource reference for Resource ${resourceId}:`,
-//           },
-//           {
-//             type: 'resource',
-//             resource: resource,
-//           },
-//           {
-//             type: 'text',
-//             text: `You can access this resource using the URI: ${resource.uri}`,
-//           },
-//         ],
-//       };
-//     }
-//     if (name === ToolName.ANNOTATED_MESSAGE) {
-//       const { messageType, includeImage } = AnnotatedMessageSchema.parse(args);
-//       const content = [];
-//       // Main message with different priorities/audiences based on type
-//       if (messageType === 'error') {
-//         content.push({
-//           type: 'text',
-//           text: 'Error: Operation failed',
-//           annotations: {
-//             priority: 1.0, // Errors are highest priority
-//             audience: ['user', 'assistant'], // Both need to know about errors
-//           },
-//         });
-//       } else if (messageType === 'success') {
-//         content.push({
-//           type: 'text',
-//           text: 'Operation completed successfully',
-//           annotations: {
-//             priority: 0.7, // Success messages are important but not critical
-//             audience: ['user'], // Success mainly for user consumption
-//           },
-//         });
-//       } else if (messageType === 'debug') {
-//         content.push({
-//           type: 'text',
-//           text: 'Debug: Cache hit ratio 0.95, latency 150ms',
-//           annotations: {
-//             priority: 0.3, // Debug info is low priority
-//             audience: ['assistant'], // Technical details for assistant
-//           },
-//         });
-//       }
-//       // Optional image with its own annotations
-//       if (includeImage) {
-//         content.push({
-//           type: 'image',
-//           data: MCP_TINY_IMAGE,
-//           mimeType: 'image/png',
-//           annotations: {
-//             priority: 0.5,
-//             audience: ['user'], // Images primarily for user visualization
-//           },
-//         });
-//       }
-//       return { content };
-//     }
-//     throw new Error(`Unknown tool: ${name}`);
-//   });
-//   server.setRequestHandler(CompleteRequestSchema, async (request) => {
-//     const { ref, argument } = request.params;
-//     if (ref.type === 'ref/resource') {
-//       const resourceId = ref.uri.split('/').pop();
-//       if (!resourceId) return { completion: { values: [] } };
-//       // Filter resource IDs that start with the input value
-//       const values = EXAMPLE_COMPLETIONS.resourceId.filter((id) =>
-//         id.startsWith(argument.value),
-//       );
-//       return { completion: { values, hasMore: false, total: values.length } };
-//     }
-//     if (ref.type === 'ref/prompt') {
-//       // Handle completion for prompt arguments
-//       const completions =
-//         EXAMPLE_COMPLETIONS[argument.name as keyof typeof EXAMPLE_COMPLETIONS];
-//       if (!completions) return { completion: { values: [] } };
-//       const values = completions.filter((value) =>
-//         value.startsWith(argument.value),
-//       );
-//       return { completion: { values, hasMore: false, total: values.length } };
-//     }
-//     throw new Error(`Unknown reference type`);
-//   });
-//   server.setRequestHandler(SetLevelRequestSchema, async (request) => {
-//     const { level } = request.params;
-//     logLevel = level;
-//     // Demonstrate different log levels
-//     await server.notification({
-//       method: 'notifications/message',
-//       params: {
-//         level: 'debug',
-//         logger: 'test-server',
-//         data: `Logging level set to: ${logLevel}`,
-//       },
-//     });
-//     return {};
-//   });
-//   const cleanup = async () => {
-//     if (subsUpdateInterval) clearInterval(subsUpdateInterval);
-//     if (logsUpdateInterval) clearInterval(logsUpdateInterval);
-//     if (stdErrUpdateInterval) clearInterval(stdErrUpdateInterval);
-//   };
-//   return { server, cleanup };
-// };

package/dist/server-test.js

@@ -1,93 +0,0 @@
-"use strict";
-// import express from 'express';
-// import { randomUUID } from 'node:crypto';
-// import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-// import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
-// import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
-// import { z } from 'zod';
-Object.defineProperty(exports, "__esModule", { value: true });
-// const app = express();
-// app.use(express.json());
-// // Map to store transports by session ID
-// const transports: { [sessionId: string]: StreamableHTTPServerTransport } = {};
-// // Handle POST requests for client-to-server communication
-// app.post('/mcp', async (req, res) => {
-//   console.log('🚀 POST request received');
-//   // Check for existing session ID
-//   const sessionId = req.headers['mcp-session-id'] as string | undefined;
-//   let transport: StreamableHTTPServerTransport;
-//   if (sessionId && transports[sessionId]) {
-//     // Reuse existing transport
-//     transport = transports[sessionId];
-//   } else if (!sessionId && isInitializeRequest(req.body)) {
-//     // New initialization request
-//     transport = new StreamableHTTPServerTransport({
-//       sessionIdGenerator: () => randomUUID(),
-//       onsessioninitialized: (sessionId) => {
-//         // Store the transport by session ID
-//         transports[sessionId] = transport;
-//       },
-//     });
-//     // Clean up transport when closed
-//     transport.onclose = () => {
-//       if (transport.sessionId) {
-//         console.log('🚀 Disconnecting from MCP server');
-//         delete transports[transport.sessionId];
-//       }
-//     };
-//     const server = new McpServer({
-//       name: 'example-server',
-//       version: '1.0.0',
-//     });
-//     // ... set up server resources, tools, and prompts ...
-//     server.tool(
-//       'hello_world',
-//       'Simple Hello World tool',
-//       {
-//         name: z.string().optional().describe('Your name'),
-//       },
-//       async ({ name }) => ({
-//         content: [
-//           {
-//             type: 'text',
-//             text: `Hello, ${name ?? 'World'}! This response comes from an SSE MCP server.`,
-//           },
-//         ],
-//       }),
-//     );
-//     // Connect to the MCP server
-//     console.log('🚀 Connecting to MCP server');
-//     await server.connect(transport);
-//   } else {
-//     // Invalid request
-//     res.status(400).json({
-//       jsonrpc: '2.0',
-//       error: {
-//         code: -32000,
-//         message: 'Bad Request: No valid session ID provided',
-//       },
-//       id: null,
-//     });
-//     return;
-//   }
-//   // Handle the request
-//   await transport.handleRequest(req, res, req.body);
-// });
-// // Reusable handler for GET and DELETE requests
-// const handleSessionRequest = async (
-//   req: express.Request,
-//   res: express.Response,
-// ) => {
-//   const sessionId = req.headers['mcp-session-id'] as string | undefined;
-//   if (!sessionId || !transports[sessionId]) {
-//     res.status(400).send('Invalid or missing session ID');
-//     return;
-//   }
-//   const transport = transports[sessionId];
-//   await transport.handleRequest(req, res);
-// };
-// // Handle GET requests for server-to-client notifications via SSE
-// app.get('/mcp', handleSessionRequest);
-// // Handle DELETE requests for session termination
-// app.delete('/mcp', handleSessionRequest);
-// app.listen(4000);

package/dist/sse.js

@@ -1,134 +0,0 @@
-"use strict";
-// #!/usr/bin/env node
-// import express, { Request, Response } from 'express';
-// import cors from 'cors';
-// import dotenv from 'dotenv';
-// import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-// import { z } from 'zod';
-// import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
-Object.defineProperty(exports, "__esModule", { value: true });
-// // Load .env
-// dotenv.config();
-// // Environment variables
-// const CV_API_BASE_URL = 'https://wf5whhzd-8081.brs.devtunnels.ms';
-// const CV_API_SIMPLIFIED_BASE_URL = `${CV_API_BASE_URL}/simplified`;
-// const API_KEY = process.env.CARBON_VOICE_API_KEY;
-// if (!API_KEY) {
-//   console.error('❌ Missing CARBON_VOICE_API_KEY');
-//   process.exit(1);
-// }
-// // ---- API CLIENT ---- //
-// class CarbonVoiceClient {
-//   constructor(private apiKey: string) {}
-//   async listChannels(limit = 100, cursor = '') {
-//     try {
-//       const res = await fetch(
-//         `${CV_API_SIMPLIFIED_BASE_URL}/conversations/all`,
-//         {
-//           headers: {
-//             'x-api-key': this.apiKey,
-//             'Content-Type': 'application/json',
-//           },
-//         },
-//       );
-//       if (!res.ok) throw new Error(`Failed with status ${res.status}`);
-//       return await res.json();
-//     } catch (error) {
-//       console.error('🔴 Error in listChannels:', error);
-//       return null;
-//     }
-//   }
-// }
-// const client = new CarbonVoiceClient(API_KEY);
-// // ---- MCP SERVER ---- //
-// const server = new McpServer({
-//   name: 'Carbon Voice MCP Server (SSE)',
-//   version: '1.0.0',
-//   capabilities: {
-//     resources: {},
-//     tools: {},
-//   },
-// });
-// server.tool(
-//   'list_channels',
-//   'List channels',
-//   {
-//     workspace_id: z.string().optional().describe('Carbon Voice workspace ID'),
-//   },
-//   async ({ workspace_id }) => {
-//     const channelsData = await client.listChannels(100, '');
-//     if (!channelsData) {
-//       return {
-//         content: [
-//           {
-//             type: 'text',
-//             text: 'Failed to retrieve channels data',
-//           },
-//         ],
-//       };
-//     }
-//     return {
-//       content: [
-//         {
-//           type: 'text',
-//           text: JSON.stringify(channelsData),
-//         },
-//       ],
-//     };
-//   },
-// );
-// // ---- EXPRESS + SSE ---- //
-// async function run() {
-//   const app = express();
-//   app.use(cors());
-//   app.use(express.json());
-//   const transports = new Map<string, SSEServerTransport>();
-//   app.get('/mcp/stream', async (req: Request, res: Response) => {
-//     const clientId = crypto.randomUUID();
-//     const transport = new SSEServerTransport('/mcp/stream', res);
-//     transports.set(clientId, transport);
-//     // Connect the SSE transport (this writes SSE headers) BEFORE writing any response
-//     await server.connect(transport);
-//     // Send a "clientId" event (so the client knows its ID)
-//     res.write(`event: clientId\ndata: ${clientId}\n\n`);
-//     // Send a "list_tools" event (so the client sees available tools) – mimicking MCP protocol's tool discovery
-//     const toolsList = {
-//       type: 'list_tools',
-//       tools: [
-//         {
-//           name: 'list_channels',
-//           description: 'List channels',
-//           args_schema: { workspace_id: 'string (optional)' },
-//         },
-//       ],
-//     };
-//     res.write(`event: list_tools\ndata: ${JSON.stringify(toolsList)}\n\n`);
-//     req.on('close', () => transports.delete(clientId));
-//     console.log('✅ SSE MCP server connected (transport started)');
-//   });
-//   app.post('/mcp/message', async (req: any, res: any) => {
-//     // if (!transport) {
-//     //   return res.status(400).send('❌ SSE transport not initialized');
-//     // }
-//     // await transport.handlePostMessage(req, res, req.body);
-//     const { clientId, ...body } = req.body;
-//     const transport = transports.get(clientId);
-//     if (!transport) {
-//       return res.status(400).send('❌ SSE connection not established');
-//     }
-//     try {
-//       return await transport.handlePostMessage(req, res, body);
-//     } catch (error) {
-//       console.error('🔴 Error in handlePostMessage:', error);
-//       return res.status(500).send('❌ Error processing message');
-//     }
-//   });
-//   const PORT = process.env.PORT ?? 3333;
-//   app.listen(PORT, () =>
-//     console.log(`✅ SSE MCP server listening at http://localhost:${PORT}/mcp`),
-//   );
-// }
-// run().catch((err) => {
-//   console.error('🛑 Fatal server error:', err);
-//   process.exit(1);
-// });

package/dist/sse.v2.js

@@ -1,29 +0,0 @@
-"use strict";
-// import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
-// import { createServer } from './server.js';
-// import express from 'express';
-Object.defineProperty(exports, "__esModule", { value: true });
-// // Create Express app and MCP server
-// const app = express();
-// const mcpServer = createServer();
-// // Handle SSE connections
-// app.get('/mcp', (req, res) => {
-//   const transport = new SSEServerTransport('/mcp', res);
-//   // Set SSE headers
-//   res.setHeader('Content-Type', 'text/event-stream');
-//   res.setHeader('Cache-Control', 'no-cache');
-//   res.setHeader('Connection', 'keep-alive');
-//   res.setHeader('Access-Control-Allow-Origin', '*'); // For development, restrict in production
-//   transport.handleMessage(req);
-//   // Handle the SSE connection using the MCP server's connect method
-//   mcpServer.connect(transport);
-//   // Handle client disconnect
-//   req.on('close', () => {
-//     console.log('Client disconnected');
-//   });
-// });
-// // Start the server
-// const PORT = process.env.PORT || 3000;
-// app.listen(PORT, () => {
-//   console.log(`Server running on port ${PORT}`);
-// });