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 
   cd context-vault-app

1. 设置环境变量

   cp backend/.env.example backend/.env
   # Edit backend/.env with your database credentials

1. 启动所有服务

   docker-compose up -d

1. 运行数据库迁移

   cd backend
   npm install
   npm run migrate

1. 种子初始数据 （可选）

   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

📚 文档

• 架构指南
• api参考
• 部署指导

🎯 成功指标

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

🛠️ 技术栈

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

📝 许可证

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

🤝 贡献

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

📧 联系

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

______________________________________________________________________

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