AI工作流编排服务器

Context Vault是一个模型上下文协议(MCP)服务器,将ChatGPT/Claude连接到结构化知识库,通过ASSET框架实现AI辅助工作流执行。

  • by emmanuelsystems
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 emmanuelsystems/context-vault-app

使用说明

Context Vault-人工智能工作台MCP应用程序

将您的Context Vault从静态存储库转换为实时AI编排层。

🎯 概述

Context Vault是一个模型上下文协议(MCP)服务器,它将ChatGPT/Claude连接到您的结构化知识库,通过 资产框架:

  • **A.**助手:人工智能角色(DAB-数字人工智能机器人)
  • S来源:上下文数据(佳能核心块)
  • S结构化输出:输出模板(形状)
  • E期望:质量标准
  • T问:目标陈述

🏗️ 建筑

┌─────────────────────┐
│  ChatGPT / Claude   │  ← AI Host
└──────────┬──────────┘
           │ MCP Protocol
┌──────────▼──────────┐
│   MCP Server        │  ← Exposes 7 tools
│   (TypeScript)      │
└──────────┬──────────┘
           │ REST API
┌──────────▼──────────┐
│  Backend API        │  ← Business Logic
│  (Express + Prisma) │
└──────────┬──────────┘
           │
┌──────────▼──────────┐
│  PostgreSQL         │  ← Canonical Data Store
│  (Plays, Canon,     │
│   Shapes, DABs,     │
│   Runs, Assets)     │
└─────────────────────┘

🚀 快速开始

先决条件

  • Docker&Docker编写
  • Node.js 18+(用于本地开发)
  • PostgreSQL 15+(或使用Docker)

安装

  1. 克隆存储库

    git clone <your-repo-url>
    cd context-vault-app
    
  2. 设置环境变量

    cp backend/.env.example backend/.env
    # Edit backend/.env with your database credentials
    
  3. 启动所有服务

    docker-compose up -d
    
  4. 运行数据库迁移

    cd backend
    npm install
    npm run migrate
    
  5. 种子初始数据 (可选)

    npm run seed
    

接入点

  • 后端API: http://localhost:3000
  • MCP服务器:stdio(通过ChatGPT连接)
  • 工作台小部件:嵌入在ChatGPT中

📦 组件

1.后端API(/backend)

Express.js+Prisma后端提供REST API,用于:

  • 游戏管理
  • 核心块(佳能)存储
  • 形状库
  • DABs(数字人工智能机器人)
  • 运行跟踪
  • 资产银行业务

2.MCP服务器(/mcp-server)

模型上下文协议服务器公开了7个工具:

  • cv_list_plays:列出可用播放
  • cv_list_core_blocks:列出核心块(佳能)
  • cv_list_shapes:列出输出形状
  • cv_list_dabs:列出DAB(AI角色)
  • cv_assemble_asset:组装完整的ASSET提示
  • cv_create_run:创建新的跑步记录
  • cv_update_run_judge:更新运行状态和银行资产

3.工作台小部件(/workbench-widget)

ChatGPT中嵌入的React UI用于:

  • 播放选择
  • 目标定义
  • 背景审查
  • 资产预览
  • 法官与银行

🔧 发展

后端开发

cd backend
npm install
npm run dev      # Start with hot reload
npm run test     # Run tests
npm run migrate  # Run database migrations

MCP服务器开发

cd mcp-server
npm install
npm run dev      # Start MCP server
npm run build    # Build for production

小工具开发

cd workbench-widget
npm install
npm run dev      # Start Vite dev server
npm run build    # Build for production

📊 数据库模式

核心实体:

  • 戏剧:可重复的工作流模板
  • 核心块:结构化客户知识(佳能)
  • 形状:输出模板
  • 轻触:AI角色定义
  • 跑:执行记录
  • 资产:库存、批准的产出

看 backend/src/database/schema.sql 对于完整模式。

🧪 测试

# Backend tests
cd backend && npm test

# MCP Server tests
cd mcp-server && npm test

# Widget tests
cd workbench-widget && npm test

📚 文档

🎯 成功指标

  • 减少手动复制粘贴步骤 每次跑步
  • 银行利率:产生银行资产的跑步百分比
  • 首通验收:在裁判中标记为“通过”的分数百分比

🛠️ 技术栈

  • 后端:TypeScript、Express.js、Prisma、PostgreSQL
  • MCP服务器:TypeScript,@modelcontextprotocol/sdk
  • 小部件:React、TypeScript、TailwindCSS、Vite
  • 基础设施:Docker,Docker Compose

📝 许可证

MIT许可证-有关详细信息,请参阅许可证文件

🤝 贡献

  1. 复刻仓库
  2. 创建要素分支
  3. 提交您的更改
  4. 推到分支
  5. 打开拉取请求

📧 联系

如有疑问或支持,请打开问题。


内置于❤️ 用于人工智能辅助的工作流编排