Oracle V2

Arra Oracle-MCP内存层

“Oracle留住人类”-现在可通过MCP查询

Phukhao Oracle正在这里登陆：https://phukhao.buildwithoracle.com/presentation/

用于Oracle哲学语义搜索的TypeScript MCP服务器-SQLite FTS5+ChromaDB混合搜索、HTTP API和vault CLI。

看 docs/LOCAL-DEV.md 为了地方发展。

建筑

arra-oracle-v3 (one package, two bins)
├── bunx arra-oracle-v2                          → MCP server (src/index.ts)
├── bunx --package arra-oracle-v2 oracle-vault   → Vault CLI (src/vault/cli.ts)
├── bun run server                          → HTTP API (src/server.ts)
└── bun run index                           → Indexer (src/indexer.ts)

oracle-studio (separate repo)
└── bunx oracle-studio                      → React dashboard

堆栈：

• 包子 运行时间（>=1.2.0）
• SQLite +FTS5用于全文搜索
• 色度数据库 用于矢量/语义搜索
• 淋ORM 用于类型安全查询
• 荣誉 用于HTTP API
• 主控程序 克劳德集成协议

安装

bunx（推荐）

通过GitHub分发——无需npm发布：

# Backend (MCP server)
bunx --bun arra-oracle@github:Soul-Brews-Studio/arra-oracle-v3

# CLI (plugin runner)
bunx --bun arra-cli@github:Soul-Brews-Studio/arra-oracle-v3 --help

# UI (dashboard — separate repo)
bunx --bun oracle-studio@github:Soul-Brews-Studio/oracle-studio

# Vault CLI (secondary bin — use --package)
bunx --bun --package arra-oracle-v2@github:Soul-Brews-Studio/arra-oracle-v3#main oracle-vault --help

添加到克劳德代码

claude mcp add arra-oracle-v2 -- bunx --bun arra-oracle-v2@github:Soul-Brews-Studio/arra-oracle-v3#main

或在 ~/.claude.json:

{
  "mcpServers": {
    "arra-oracle-v2": {
      "command": "bunx",
      "args": ["--bun", "arra-oracle-v2@github:Soul-Brews-Studio/arra-oracle-v3#main"]
    }
  }
}

来源

git clone https://github.com/Soul-Brews-Studio/arra-oracle-v3.git
cd arra-oracle-v3 && bun install
bun run dev          # MCP server
bun run server       # HTTP API on :47778

Install script (legacy)

curl -sSL https://raw.githubusercontent.com/Soul-Brews-Studio/arra-oracle-v3/main/scripts/install.sh | bash

Troubleshooting

MCP工具

克劳德代码提供22个工具：

Vault CLI

用于管理Oracle知识库的全局CLI：

oracle-vault init     # Initialize vault with GitHub repo
oracle-vault status               # Show config and pending changes
oracle-vault sync                 # Commit + push to GitHub
oracle-vault pull                 # Pull vault files into local ψ/
oracle-vault migrate              # Seed vault from ghq repos

API终点

端口47778上的HTTP API(bun run server).

自动生成 bun run scripts/gen-endpoints.ts14个模块中的55个端点。

数据库

用SQLite喷洒ORM：

bun db:push       # Push schema to DB
bun db:generate   # Generate migrations
bun db:migrate    # Apply migrations
bun db:studio     # Open Drizzle Studio GUI

项目结构

arra-oracle-v3/
├── src/
│   ├── index.ts          # MCP server entry
│   ├── server.ts         # HTTP API (Hono)
│   ├── indexer.ts        # Knowledge indexer
│   ├── vault/
│   │   └── cli.ts        # Vault CLI entry
│   ├── tools/            # MCP tool handlers
│   ├── trace/            # Trace system
│   ├── db/
│   │   ├── schema.ts     # Drizzle schema
│   │   └── index.ts      # DB client
│   └── server/           # HTTP server modules
├── scripts/              # Setup & utility scripts
├── docs/                 # Documentation
└── drizzle.config.ts     # Drizzle configuration

配置

测试

bun test              # All tests
bun test:unit         # Unit tests
bun test:integration  # Integration tests
bun test:e2e          # Playwright E2E tests
bun test:coverage     # With coverage

欢迎新的觉醒

唤醒一位新的先知？发布出生公告和经验报告 到 讨论, 不是问题。看 docs/贡献-觉醒.md 类别和签名惯例。

参考文献

• 时间线.md -完整的进化历史
• docs/API.md文件 -API文件
• docs/architecture.md -建筑细节
• docs/贡献-觉醒.md -在哪里发布觉醒公告
• 淋ORM
• MCP-SDK

致谢

受...启发 克劳德·梅 作者：Alex Newman——流程管理器模式、员工服务架构和挂钩系统概念。