{"_id":"@aintent/mcp-kit","name":"@aintent/mcp-kit","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aintent/mcp-kit","version":"1.0.0","description":"Model Context Protocol (MCP) SDK by Aintent.ai, an Axes Labs company","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","test":"jest","lint":"eslint src/**/*.ts","format":"prettier --write src/**/*.ts","docs":"typedoc src/index.ts","prepublishOnly":"npm run build","prepare":"npm run build","preversion":"npm run lint","version":"npm run format && git add -A src","postversion":"git push && git push --tags"},"keywords":["intent","mcp","ai","workflow","deep-intent","sdk","chat","flow-viewer","typescript"],"author":{"name":"Aintent.ai","email":"aby@helloaxes.com","url":"https://aintent.ai"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aintent/mcp-kit.git"},"bugs":{"url":"https://github.com/aintent/mcp-kit/issues","email":"aby@helloaxes.com"},"homepage":"https://aintent.ai","dependencies":{"tslib":"^2.5.0"},"devDependencies":{"@types/jest":"^29.5.0","@types/node":"^18.15.11","@typescript-eslint/eslint-plugin":"^5.57.1","@typescript-eslint/parser":"^5.57.1","eslint":"^8.37.0","jest":"^29.5.0","prettier":"^2.8.7","ts-jest":"^29.1.0","typedoc":"^0.24.1","typescript":"^5.0.3"},"engines":{"node":">=14.0.0"},"publishConfig":{"access":"public"},"_id":"@aintent/mcp-kit@1.0.0","gitHead":"00547ebe0d6f47b5efaf917167f531cf704dd57c","_nodeVersion":"20.11.1","_npmVersion":"10.2.4","dist":{"integrity":"sha512-mjRHkFPIS76b5k2A131DrKifqKOav1mbVrv/BvmCNP40nZy4h3RZWFviv1MtfZoT7lAuCdTo3gFGLgQJWrEmSA==","shasum":"fbb77df1c5a6cb864ed5df5d627d9af88d099fcc","tarball":"https://registry.npmjs.org/@aintent/mcp-kit/-/mcp-kit-1.0.0.tgz","fileCount":15,"unpackedSize":48878,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC6SgjrG4wAzKRwE36Dv3iWrhs21QZ9MoFFqiaXgKjlyAIgTDp8Eul+C9iEPx+zmDA0+n9l2g9gMnijx/GF3N2Pikg="}]},"_npmUser":{"name":"axeslabs","email":"axesintent@gmail.com"},"directories":{},"maintainers":[{"name":"axeslabs","email":"axesintent@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-kit_1.0.0_1744052161381_0.14052644792068558"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-07T18:56:01.318Z","1.0.0":"2025-04-07T18:56:01.642Z","modified":"2025-04-07T18:56:01.882Z"},"maintainers":[{"name":"axeslabs","email":"axesintent@gmail.com"}],"description":"Model Context Protocol (MCP) SDK by Aintent.ai, an Axes Labs company","homepage":"https://aintent.ai","keywords":["intent","mcp","ai","workflow","deep-intent","sdk","chat","flow-viewer","typescript"],"repository":{"type":"git","url":"git+https://github.com/aintent/mcp-kit.git"},"author":{"name":"Aintent.ai","email":"aby@helloaxes.com","url":"https://aintent.ai"},"bugs":{"url":"https://github.com/aintent/mcp-kit/issues","email":"aby@helloaxes.com"},"license":"MIT","readme":"# Intent MCP Kit 🚀\n\n<div align=\"center\">\n\n[![npm version](https://img.shields.io/npm/v/@aintent/mcp-kit.svg?style=flat)](https://www.npmjs.com/package/@aintent/mcp-kit)\n[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/aintent/mcp-kit/pulls)\n\n</div>\n\n<p align=\"center\">\n  <strong>A powerful SDK for Model Context Protocol (MCP) by Aintent.ai, an Axes Labs company.</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"#features\">Features</a> •\n  <a href=\"#quick-start\">Quick Start</a> •\n  <a href=\"#installation\">Installation</a> •\n  <a href=\"#usage\">Usage</a> •\n  <a href=\"#widgets\">Widgets</a> •\n  <a href=\"#api\">API</a> •\n  <a href=\"#examples\">Examples</a> •\n  <a href=\"#documentation\">Documentation</a>\n</p>\n\n## Features ✨\n\n- 🎯 **Intent Processing**: Advanced natural language understanding and intent classification\n- 🔄 **Workflow Generation**: Automated workflow creation from natural language inputs\n- 🎨 **Interactive Widgets**: Ready-to-use UI components for chat and flow visualization\n- 🛠️ **Extensible Architecture**: Easy to customize and extend with your own components\n- 📦 **TypeScript Ready**: Full TypeScript support with comprehensive type definitions\n- 🔌 **Plugin System**: Extensible plugin architecture for custom integrations\n- 🎭 **Theme Support**: Light and dark themes out of the box\n- 📱 **Responsive Design**: Works seamlessly on desktop and mobile\n\n## Quick Start 🚀\n\n```typescript\nimport { MCPClient, ChatWidget } from '@aintent/mcp-kit';\n\n// Initialize the client\nconst client = new MCPClient({\n  apiKey: 'your-api-key'\n});\n\n// Create a chat widget\nconst chat = new ChatWidget('#chat-container', client, {\n  theme: 'light',\n  height: '500px'\n});\n\n// Process intents and generate workflows\nchat.on('message', async (message) => {\n  const intent = await client.processIntent(message);\n  const flow = await client.generateWorkflow(intent);\n  await client.executeWorkflow(flow);\n});\n```\n\n## Installation 📦\n\n```bash\n# Using npm\nnpm install @aintent/mcp-kit\n\n# Using yarn\nyarn add @aintent/mcp-kit\n\n# Using pnpm\npnpm add @aintent/mcp-kit\n```\n\n## Usage 💡\n\n### Core Client\n\n```typescript\nimport { MCPClient } from '@aintent/mcp-kit';\n\nconst client = new MCPClient({\n  apiKey: 'your-api-key',\n  options: {\n    timeout: 5000,\n    retries: 3\n  }\n});\n\n// Process an intent\nconst intent = await client.processIntent('Deploy the application to production');\n\n// Generate a workflow\nconst flow = await client.generateWorkflow(intent);\n\n// Execute the workflow\nconst result = await client.executeWorkflow(flow);\n```\n\n### Interactive Chat\n\n```typescript\nimport { ChatWidget } from '@aintent/mcp-kit';\n\nconst chat = new ChatWidget('#chat', client, {\n  theme: 'dark',\n  height: '600px',\n  placeholder: 'What would you like to do?',\n  maxMessages: 100,\n  autoScroll: true\n});\n\n// Listen for events\nchat.on('message', (message) => {\n  console.log('New message:', message);\n});\n```\n\n### Flow Visualization\n\n```typescript\nimport { FlowViewerWidget } from '@aintent/mcp-kit';\n\nconst viewer = new FlowViewerWidget('#viewer', flow, {\n  height: '800px',\n  theme: 'light',\n  zoom: {\n    min: 0.5,\n    max: 3,\n    step: 0.1\n  }\n});\n\n// Update flow data\nviewer.updateFlow(newFlow);\n```\n\n## Widgets 🎨\n\nThe SDK includes ready-to-use UI components:\n\n- **ChatWidget**: Interactive chat interface for natural language interactions\n- **FlowViewerWidget**: Visual workflow representation with zoom and pan capabilities\n- **Custom Widgets**: Extend `MCPWidget` to create your own components\n\n[Learn more about widgets →](./docs/widgets/README.md)\n\n## API Reference 📚\n\n### MCPClient\n\n- `processIntent(input: string): Promise<DeepIntent>`\n- `generateWorkflow(intent: DeepIntent): Promise<DeepFlow>`\n- `executeWorkflow(flow: DeepFlow): Promise<WorkflowResult>`\n\n### Widgets\n\n- `ChatWidget`: [Documentation](./docs/widgets/chat-widget.md)\n- `FlowViewerWidget`: [Documentation](./docs/widgets/flow-viewer-widget.md)\n- `MCPWidget`: [Base Class Documentation](./docs/widgets/base-widget.md)\n\n[Full API Documentation →](./docs/api/README.md)\n\n## Examples 🎮\n\n### Basic Intent Processing\n\n```typescript\nconst result = await client.processIntent('Scale the web service to 5 replicas');\nconsole.log(result.confidence); // 0.95\nconsole.log(result.action); // { type: 'scale', target: 'web-service', replicas: 5 }\n```\n\n### Workflow Generation\n\n```typescript\nconst workflow = await client.generateWorkflow({\n  action: 'deploy',\n  target: 'web-app',\n  environment: 'production'\n});\n\nconsole.log(workflow.steps); // Array of workflow steps\nconsole.log(workflow.resources); // Required resources\n```\n\n[More Examples →](./examples/README.md)\n\n## Documentation 📖\n\n- [Getting Started Guide](./docs/getting-started.md)\n- [Core Concepts](./docs/concepts.md)\n- [Widget Documentation](./docs/widgets/README.md)\n- [API Reference](./docs/api/README.md)\n- [Examples](./examples/README.md)\n- [Contributing Guide](./CONTRIBUTING.md)\n\n## Contributing 🤝\n\nWe welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.\n\n1. Fork the repository\n2. Create your feature branch\n3. Commit your changes\n4. Push to the branch\n5. Create a Pull Request\n\n## License 📄\n\nThis project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.\n\n## Support 💬\n\n- 📧 Email: aby@helloaxes.com\n- 🐦 Twitter: [@aintent_](https://x.com/aintent_)\n- 👨‍💻 Founder: [@magicofanon](https://x.com/magicofanon)\n- 📝 Blog: [Aintent Blog](https://blog.aintent.ai)\n\n---\n\n<p align=\"center\">Made with ❤️ by Aintent.ai, an Axes Labs company</p>\n\n<p align=\"center\">\n  <a href=\"https://aintent.ai\">Website</a> •\n  <a href=\"https://docs.aintent.ai\">Documentation</a> •\n  <a href=\"https://github.com/openpandacodes/intent-mcp-kit\">GitHub</a>\n</p>\n","readmeFilename":"README.md","_rev":"1-8e973f1a050ab208b8de16fff71f0864"}