使用说明
🤖 CRM人工智能代理-MCP服务器
企业级 模型上下文协议（MCP） 服务器充当CRM和项目管理平台内人工智能操作的集中“大脑”和“卫士”。
🏗️ 技术架构
该项目遵循严格的 分层架构 以确保安全性、可扩展性和可维护性。
| 层 | 类比 | 描述 |
|---|---|---|
| 工具 | 菜单 | 暴露给LLM的公共接口（Cursor、Claude等）。 |
| 能力 | 大脑 | 核心人工智能业务逻辑、计算和分析。 |
| 政策 | Guard | 对每个请求进行粒度权限检查（RBAC）。 |
| 上下文 | 图书管理员 | 数据抽象层，通过Prisma从数据库中获取原始数据。 |
| 提示 | 脚本 | （计划）解耦模板控制人工智能的说话方式。 |
🛠️ 集成功能和工具
服务器公开了用于项目管理和财务分析的专用工具：
1.项目见解
get_project_summary：生成项目进度、模块状态和利益相关者活动的详细概述。get_project_risk：对时间线速度差距、预算健康状况和停滞警报进行高级分析。
2.智能动作
suggest_tasks：为新项目蓝图生成具有行业意识的任务和模块。generate_email_draft：用于付款提醒、状态更新和客户签到的上下文感知起草。
3.财务分析
explain_invoice：将复杂的财务文件翻译成简单的术语，包括预算使用影响。
🛡️ 安全和访问控制
此服务器是 身份识别。每个工具调用都会被拦截 AIPermissionsPolicy 验证：
- 项目成员：用户只能看到分配给他们的项目。
- 角色许可：财务细节仅限于
ADMIN和OWNER角色。 - 上下文注入：标准化
server.ts以防止“幽灵”或匿名请求。
🚀 入门指南
先决条件
- Node.js 16+
- 通过Prisma连接的正在运行的数据库（PostgreSQL/MongoDB）。
安装
npm install
发展
# Run with live reload
npm run dev
生产建设
npm run build
npm start
环境变量
创建一个 .env 根目录中的文件：
DATABASE_URL="your_database_url"
📜 开发标准
- 严格类型：所有数据流都是通过以下方式键入的
ai.types.ts. - 集中式处理程序：工具使用
registerMcpTool助手在server.ts用于一致的错误处理。 - 关系完整性：上下文层使用Prisma
select和include以尽量减少数据库往返。
