🗂️ BigRack.dev
用于人工智能开发中任务和上下文管理的MCP服务器
⚠️ BETA预览:该项目目前处于公测阶段。接口和数据库模式可能会发生变化。在生产环境中小心使用。
 ](https://www.npmjs.com/package/@bigrack/mcp) ](https://nodejs.org/)
BigRack是一个 模型上下文协议(MCP) 该服务器扩展了Claude Code和Cursor等人工智能开发工具,具有高级 任务/项目管理 和 持久上下文 能力。
🚀 设置
1.构建MCP包
# From the repository root
npm run build:mcp2.在全球范围内链接套餐
# Link for local development
npm link或者使用npm脚本:
npm run link:mcp3.全局初始化BigRack
# Run once per machine (initializes ~/.bigrack/)
bigrack init这将在您的计算机上设置全局BigRack环境。
4.配置您的AI助手
对于Claude Desktop:
bigrack setup-claude然后重新启动Claude Desktop。
对于光标:
bigrack setup-cursor📖 接下来是什么?
设置后,您可以:
- 初始化项目:在项目目录中,使用Claude/Cursor调用
bigrack_create_repo-这将创建bigrack.json并将您的项目链接到BigRack - 店铺业务背景:请Claude/Cursor存储业务规则、术语表术语或架构模式
- 创建项目:为功能或错误修复创建新项目(Pallet)
- 分解特征:将复杂功能分解为具有依赖关系的原子任务
- 查询上下文:使用语义搜索查找相关的业务规则和模式
🎯 问题
像Claude Code这样的人工智能助手功能强大,但在复杂项目上面临重大限制:
- 渐进式上下文丢失:谈话中提到的细节被遗忘了
- 规划不足:难以管理具有依赖关系的复杂任务
- 过早简化:缺少边缘案例和重要业务验证
- 被遗忘的商业规则:关键制约因素在发展过程中消失
💡 解决方案
BigRack提供 结构化、持久的上下文 AI始终可以通过模型上下文协议进行咨询。把它看作是给你的人工智能助手一个 长期记忆 用于项目的业务规则、架构决策和任务依赖关系。
✨ 主要特点
📡 MCP协议
使用自定义工具扩展AI助手的标准协议。适用于:
- 克劳德代码 (人类学)
- 光标 (任何领域)
- 任何兼容MCP的AI助手
📦 任务分解
- 将复杂特征分解为 原子任务
- 自动 依赖图 (DAG)创建
- 基于优先级和拦截器的智能任务推荐
- 跟踪进度
pending,in-progress,completed,blocked状态
🧠 上下文管理
- 商店 商业规则, 术语表, 体系结构模式,以及 团队惯例
- 语义搜索 由向量嵌入提供动力(Xenova/all-MiniLM-L6-v2,384维)
- 用于智能上下文检索的RAG(检索增强生成)
- 使用自然语言查询上下文: _“身份验证要求是什么?”_
🏠 当地第一建筑
- 100%本地 -使用SQLite存储在计算机上的所有数据
- 嵌入式矢量搜索 -不需要外部API或服务
- 零云依赖 -完全离线工作
- 隐私第一 -你的代码永远不会离开你的机器
📚 核心概念
机架(存储库)
A. 机架 表示业务域或代码库。它是以下物品的主要容器:
- 业务规则
- 术语表
- 体系结构模式
- 团队惯例
- 每个项目目录一个机架(由标识
bigrack.json)
项目
A. 项目 表示特定的工作单元(功能、错误修复、重构):
- 自动从父机架继承上下文
- 可以具有特定于项目的上下文
- 包含具有依赖关系的任务
- 链接到Git分支
任务
一 原子任务 与:
- 标题、描述、状态、优先级、类型
- 依赖关系(必须先完成的其他任务)
- 验证标准
- 预计时间
- Git分支跟踪
矢量搜索和RAG
- 所有业务上下文都使用以下方式自动嵌入 Xenova/全迷你LM-L6-v2 (约22.6 MB)
- 384维度 向量嵌入
- 自然语言查询返回最相关的上下文
- 跑 100%本地 没有外部API调用
🛠️ CLI命令
全局设置
bigrack init # Initialize BigRack globally (once per machine)
bigrack status # Show current repository status项目管理
bigrack projects create --name "Feature X" --type feature
bigrack projects list任务管理
bigrack ticket list # List all tasks
bigrack ticket list --status pending # Filter by status
bigrack ticket list --priority critical # Filter by priority
bigrack ticket get # Show task details上下文管理
bigrack context add --type business_rule --name "Rule" --description "..."
bigrack context query "authentication requirements"
bigrack context list配置
bigrack config show # Show current configuration
bigrack config get # Get config value
bigrack config set # Set config value🏗️ 建筑
bigrack.dev/
├── apps/
│ ├── website/ # Marketing website (Next.js 14)
│ ├── api/ # Backend API (future)
│ └── dashboard/ # Web dashboard (future)
├── packages/
│ ├── mcp/ # @bigrack/mcp - MCP server (THIS IS THE CORE)
│ │ ├── src/
│ │ │ ├── mcp/ # MCP server & tools
│ │ │ ├── cli/ # CLI commands
│ │ │ ├── storage/ # SQLite + Prisma
│ │ │ ├── embeddings/ # Vector embeddings
│ │ │ └── logger/ # Pino logger
│ │ └── prisma/ # Database schema
│ ├── shared/ # Shared types & utilities
│ └── config/ # Shared configs
└── LICENSE # Apache License 2.0📦 技术栈
MCP服务器(本地)
- 运行时:Node.js 20+,TypeScript 5.3+
- 数据库:通过Prisma ORM实现SQLite
- 矢量搜索:Xenova/transformers.js(本地嵌入)
- 模型:全MiniLM-L6-v2(384尺寸,约22.6 MB)
- 命令行界面:指挥官,问询者,粉笔,奥拉
- 日志记录:皮诺
网站
- 框架:Next.js 14(应用路由器)
- 样式:顺风CSS+shadcn/ui
- 部署:Vercel
🤝 贡献
我们欢迎捐款!看 贡献.md 作为指导方针。
开发设置
# Clone repository
git clone https://github.com/baptiste-mnh/bigrack.dev.git
cd bigrack
# Install dependencies
npm install
# Build all packages
npm run build
# Build MCP package
npm run build:mcp
# Link MCP package for local development
npm run link:mcp
# Run in development mode with auto-rebuild
npm run dev:mcp项目结构
- Monorepo管理 Turborepo
- 工作区:
apps/*和packages/* - MCP包:
packages/mcp/
承诺约定
使用 常规承诺:
feat(mcp): add ticket list command
fix(storage): resolve dependency resolution bug
docs(readme): update installation instructions📄 许可证
BigRack根据 Apache许可证2.0.
这意味着您可以:
- ✅ 商业用途
- ✅ 修改和分发
- ✅ 私下使用
- ✅ 再许可
具有以下保护功能:
- 🛡️ 专利(包括专利授权)
- 🛡️ 商标(未经许可,您不能使用“BigRack”名称)
看 许可证 了解全部细节。
⚠️ 免责声明
本软件按原样提供,不提供任何保修。
所有数据都存储在您的设备上。
有关更多详细信息,请参阅Apache 2.0许可证。
🌟 为什么选择BigRack?
对于独立开发者:
- 在漫长的开发过程中保持上下文
- 永远不要忘记业务规则和约束
- 自信地规划复杂的功能
对于团队:
- 在整个团队中共享业务背景
- 持续的人工智能辅助开发
- 跟踪进度和依赖关系
对于企业:
- 用严格的业务规则管理复杂的项目
- 合规和审计跟踪
- 数据隐私自托管
🔗 链接
- 网站: bigrack.dev
- 文档: bigrack.dev/docs
- GitHub:
- npm包: @bigrack/mcp
- 问题:
- 讨论:
______________________________________________________________________
内置于❤️ 作者@baptiste mnh
_使开发人员能够在人工智能的帮助下构建复杂的项目_
