Aintent Framework

🚀 目标 MCP 服务器

目标 MCP 服务器是一个用于处理自然语言意图的模型上下文协议（MCP）服务器，它能够将自然语言意图转换为结构化、可操作的格式。该服务器提供了强大且可靠的 API，用于管理和处理意图，尤其注重扩展性和可靠性。

🚀 快速开始

先决条件

要使用此项目，请确保安装了以下工具：

• Node.js（建议版本 14 或更高）
• npm（Node 包管理器）

安装

从 GitHub 克隆仓库并安装依赖项：

git clone https://github.com/yourusername/intent-mcp.git
cd intent-mcp
npm install

配置

可以通过以下环境变量配置服务器的行为：

• NODE_ENV：设置运行环境（development 或 production），默认为 development
• PORT：指定服务器监听的端口，默认为 3000
• DB_URI：数据库连接 URI，默认为 mongodb://localhost:27017/intents

使用

开发模式

npm run dev

生产模式

npm start

测试

npm test

✨ 主要特性

• 🎯 意图处理：通过完善的 API 创建、获取和处理意图
• 🔍 自然语言理解：解析并理解原始用户意图
• 🧩 意图分解：将意图转化为结构化对象，包含目标和约束
• 💾 灵活存储：可插拔的存储系统，附带内置的内存实现
• 📝 类型安全：完整的 TypeScript 实现，带有文档
• 🛠️ 强大 API：提供创建、读取、更新和删除意图的功能
• 🔄 扩展性设计：易于添加新的功能模块

💻 使用示例

基础用法

{
  "intentName": "order_food",
  "description": "处理食品订单"
}

高级用法

{
  "intentName": "order_food_updated",
  "description": "更新食品订单处理"
}

📚 详细文档

API 端点

创建意图

方法: POST
路径: /api/intents
请求体格式: JSON

获取所有意图

方法: GET
路径: /api/intents

根据 ID 获取意图

方法: GET
路径: /api/intents/:id

更新意图

方法: PUT
路径: /api/intents/:id
请求体格式: JSON

删除意图

方法: DELETE
路径: /api/intents/:id

🔧 技术细节

架构

该项目采用干净架构模式，分为以下几个层：

• 控制器 (Controllers)：处理 HTTP 请求和响应
• 服务 (Services)：负责业务逻辑和数据操作
• 存储 (Storage)：提供数据持久化功能
• 模型 (Models)：定义数据结构和验证规则

项目结构

intent-mcp/
├── controllers/          # 控制器
├── services/            # 服务层
├── storage/             # 存储实现
├── models/              # 数据模型
├── config/              # 配置文件
└── routes/              # 路由定义

意图结构

意图以以下 TypeScript 接口定义：

interface Intent {
  id: string;
  intentName: string;
  description: string;
  createdAt: Date;
  updatedAt: Date;
}

错误处理

该系统提供全面的错误处理机制，包括：

• 自定义错误类
• HTTP 状态码和响应体
• 日志记录和跟踪

🤝 贡献指南

欢迎贡献！请遵循以下步骤参与项目：

1. Fork 仓库到您的账户
2. 创建功能分支
3. 提交更改并创建 Pull Request
4. 更新文档（如需）

请确保提交的信息遵循 Conventional Commits 规范，并在 Pull Request 中说明变更内容。

📄 许可证

MIT License - 详情请参阅 LICENSE 文件