快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

智能助手

澳大利亚贸易企业的人工智能行政助理。一个具有MCP（模型上下文协议）代理集成的单屏幕聊天界面，用于Gmail、日历和文档处理。

开发人员设置指南

此设置指南使任何开发人员都可以克隆仓库，并从当前的第一阶段状态恢复开发。

先决条件

Node.js 18+
Docker&Docker编写
VS代码（推荐）

快速设置

克隆存储库：

   git clone 
   cd intelligent-admin

安装依赖项：

   npm install
   cd frontend && npm install
   cd ../backend && npm install

配置环境变量：

   # Copy environment template
   cp frontend/.env.example frontend/.env

设置身份验证服务：

a） Kinde身份验证设置：

- 首选 Kinde.com 并创建帐户 - 创建新项目：“智能助理” - 增添 frontend/.env:

     VITE_KINDE_CLIENT_ID=your-kinde-client-id
     VITE_KINDE_DOMAIN=https://yourdomain.kinde.com
     VITE_KINDE_REDIRECT_URI=http://localhost:5173
     VITE_KINDE_LOGOUT_URI=http://localhost:5173

b） Firebase+Gmail API设置：

- 首选 Firebase控制台 - 创建项目：“智能管理员” - 在Google云控制台中启用Gmail API - 为web应用程序创建OAuth 2.0凭据 - 添加授权来源： http://localhost:5173 - 增添 frontend/.env:

     VITE_FIREBASE_API_KEY=your-firebase-api-key
     VITE_FIREBASE_PROJECT_ID=your-project-id
     VITE_FIREBASE_APP_ID=your-app-id
     VITE_FIREBASE_MESSAGING_SENDER_ID=your-sender-id
     VITE_GOOGLE_CLIENT_ID=your-google-oauth-client-id

启动开发服务器：

   # Terminal 1: Backend
   cd backend && npm run dev

   # Terminal 2: Frontend  
   cd frontend && npm run dev

验证设置：

- 打开http://localhost:5173 - 转到“开发设置”选项卡 - 所有检查应显示绿色✅ - 测试聊天界面中的Gmail集成

接入点

前端: http://localhost:5173
后端API: http://localhost:3000
开发设置: http://localhost:5173（设置选项卡）

开发工作流程

VS代码扩展

工作区将提示您安装推荐的扩展，包括：

GitHub Copilot&Copilot聊天
TypeScript、ESLint、Prettier
Prisma、Docker、GitLens

AI助手说明

副驾驶说明: .github/COPILOT_INSTRUCTIONS.md
发展背景: .ai/development-context.md

关键命令

npm run dev          # Start both frontend and backend
npm run test         # Run all tests
npm run lint         # Run linting
npm run type-check   # Run TypeScript checks
npm run build        # Build for production

建筑

简化堆栈

前端：React+TypeScript+顺风CSS
后端：Express.js+Prisma ORM+PostgreSQL
人工智能：OpenAI API集成
实时：服务器发送的事件
MCP代理：Gmail、日历、文档处理

项目结构

├── frontend/          # React single-page application
├── backend/           # Express.js API server
├── shared/            # Shared types and utilities
├── docs/              # Documentation
├── .vscode/           # VS Code configuration
└── scripts/           # Development scripts

当前阶段：1B阶段-电子邮件智能（进行中）

已完成（1A期-基础）

✅ 使用monorepo设置项目结构
✅ VS代码配置和工作区
✅ Package.json和依赖项
✅ 基本React聊天界面
✅ 带路由的Express.js服务器
✅ 身份验证（Kinde+GoogleOAuth混合）
✅ Gmail API与现代谷歌身份服务的集成
✅ 基于人工智能分类的电子邮件分析引擎
✅ 利用商业洞察力生成晨报摘要

当前开发（1B期）

✅ Gmail OAuth集成端到端工作
✅ 已构建电子邮件提取和分析服务
✅ 清理UI以专注于核心功能
🔄 构建电子邮件智能UI组件
🔄 用于电子邮件设置的用户首选项存储

后续步骤

构建电子邮件智能仪表板UI
创建早报查看器组件
添加电子邮件分类界面
实现电子邮件分析的用户首选项

业务环境

目标市场：拥有1-50名员工的澳大利亚贸易企业（管道、电气、暖通空调）问题：管理负担阻碍了扩展（每年在管理任务上浪费560亿澳元） 解决方案：AI聊天界面取代5-8个独立的业务应用程序

开发指南

代码的风格

TypeScript严格模式
ESLint+更精细的执法
带有钩子的React功能组件
使用自定义错误类进行正确的错误处理

MCP代理模式

interface MCPAgent {
  name: string;
  capabilities: string[];
  execute(task: AgentTask): Promise;
  healthCheck(): Promise;
}

测试

所有服务的单元测试
React组件的组件测试
MCP代理的集成测试
临界流量的E2E测试

故障排除

常见问题

端口冲突：检查端口3000、5173是否可用
数据库问题：运行 npm run db:reset 后端/
Docker问题：运行 docker-compose down -v && docker-compose up -d

获取帮助

检查VS代码问题面板中的Types/ESLint问题
使用Copilot Chat获取编码帮助
审查 .ai/development-context.md 用于项目背景

环境变量引用

发展所需

# Kinde Authentication
VITE_KINDE_CLIENT_ID=your-kinde-client-id
VITE_KINDE_DOMAIN=https://yourdomain.kinde.com
VITE_KINDE_REDIRECT_URI=http://localhost:5173
VITE_KINDE_LOGOUT_URI=http://localhost:5173

# Firebase Configuration  
VITE_FIREBASE_API_KEY=your-firebase-api-key
VITE_FIREBASE_PROJECT_ID=your-project-id
VITE_FIREBASE_APP_ID=your-app-id
VITE_FIREBASE_MESSAGING_SENDER_ID=your-sender-id
VITE_FIREBASE_VAPID_KEY=your-vapid-key

# Google OAuth for Gmail API
VITE_GOOGLE_CLIENT_ID=your-google-oauth-client-id

# API Configuration
VITE_API_BASE_URL=http://localhost:3000
VITE_WEBSOCKET_URL=ws://localhost:3000

可选配置

# Feature Flags
VITE_ENABLE_DEBUG=true
VITE_ENABLE_MOCK_API=false

# UI Configuration  
VITE_DEFAULT_THEME=light
VITE_ENABLE_DARK_MODE=true

______________________________________________________________________

内置于❤️ 澳大利亚贸易企业

目录标签

文档处理TypeScriptVS CodeAI助手本地部署行政自动化贸易企业Gmail集成

支持客户端

VS Code

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

oauth

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明oauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/f32e03ec6073c116f2f7dfa1f2b490f8

一款为澳大利亚贸易企业设计的AI驱动的行政助手，集成Gmail、日历和文档处理的MCP代理功能。

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

Intelligent Agent Mvp

一个基于FastAPI和LangGraph的智能数据分析平台，提供意图识别、业务能力封装、状态机编排和RESTful API等功能。

下一个 MCP

Intelligent Form Collection MCP Server

智能表单收集MCP服务器是一个为矛盾调解业务设计的智能表单收集系统，支持与多个大模型平台集成，提供流式输出、智能信息提取和实时验证功能。

Intelligent Assistant