📄 工具详情 ⚙️ 安装教程 📚 使用教程

能力标签

🔌 MCP 🔄 工作流 🐳 Docker 💻 CLI 🔗 REST API 🧬 Embedding 🧠 Claude

🔌

MCP工具

MCP内存层

Q: arra-oracle-v3 如何安装和开始使用？

访问 arra-oracle-v3 的 GitHub 仓库或官方网站，按照 README 文档中的步骤安装依赖并运行。通常需要 Python 3.8+ 或 Node.js 16+ 基础环境。

Q: arra-oracle-v3 是否免费？许可证是什么？

arra-oracle-v3 完全免费，采用 NOASSERTION 许可证开源发布，任何人都可以免费使用、修改和分发。

Q: arra-oracle-v3 适合哪些用户使用？

arra-oracle-v3 主要面向有一定技术基础的用户，包括开发者、数据分析师、AI 工程师等专业人士。

Q: arra-oracle-v3 的社区活跃度和项目维护状况如何？

arra-oracle-v3 在 GitHub 上已获得 69 个 Star，处于积极发展阶段，社区在持续扩大。

基于 TypeScript · 让 AI 助手直接操作你的系统与工具

英文名：arra-oracle-v3

⭐ 69 Stars 🍴 59 Forks 💻 TypeScript 📄 NOASSERTION 🏷 AI 7.5分

7.5AI 综合评分

mcptypescriptsemantic search

⚙️ 配置说明

✦ AI Skill Hub 推荐

MCP内存层是 AI Skill Hub 本期精选MCP工具之一。综合评分 7.5 分，整体质量较高。我们推荐使用将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

MCP内存层是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装 MCP内存层，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。MCP内存层提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 MCP内存层评为 AI 评分 7.5 分，属于同类工具中的优质选择。

📋 工具概览

MCP内存层是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars

⭐ 69

开发语言

TypeScript

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

NOASSERTION

AI 综合评分

7.5 分

工具类型

MCP工具

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

🎯 主要使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/Soul-Brews-Studio/arra-oracle-v3

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "mcp---": {
      "command": "npx",
      "args": ["-y", "arra-oracle-v3"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📋 安装步骤说明

确认已安装 Node.js（v18 或以上版本）
打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
保存配置文件并重启 Claude 客户端
重启后，在对话中即可使用本工具

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 MCP内存层 执行以下任务...
Claude: [自动调用 MCP内存层 MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "mcp___": {
      "command": "npx",
      "args": ["-y", "arra-oracle-v3"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效

📑 README 深度解析真实文档完整度 44/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

Arra Oracle - MCP Memory Layer

"The Oracle Keeps the Human Human" - now queryable via MCP

Phukhao Oracle is landing here: https://phukhao.buildwithoracle.com/presentation/


Status	Always Nightly
Version	26.6.1-alpha.1428
Created	2025-12-29
Updated	2026-06-01

TypeScript MCP server for semantic search over Oracle philosophy — SQLite FTS5 + LanceDB hybrid search, HTTP API, and vault CLI.

See docs/LOCAL-DEV.md for local development. For Docker MCP Toolkit / Gateway / n8n installs, see docs/DOCKER-MCP-TOOLKIT.md.

Install

Configuration

Variable	Default	Description
`ORACLE_PORT`	`47778`	HTTP server port
`ORACLE_REPO_ROOT`	`process.cwd()`	Knowledge base root

CLI (operator client)

bunx --bun --package github:Soul-Brews-Studio/arra-oracle-v3 arra-cli --help

Vault CLI (secondary bin — use --package)

bunx --bun --package arra-oracle-v2@github:Soul-Brews-Studio/arra-oracle-v3#main oracle-vault --help ```

Canonical bins are arra-oracle (server) and arra-cli (client). Legacy aliases arra-oracle-v3 and arra-oracle-v2 stay available for existing installs, Docker commands, and MCP configs. See docs/BINS.md.

API Endpoints

HTTP API on port 47778 (bun run server).

Auto-generated by bun run scripts/gen-endpoints.ts. 55 endpoints across 14 modules.

Method	Path	Module	Description
`GET`	`/api/auth/status`	`auth`	Auth status - public
`POST`	`/api/auth/login`	`auth`	Login
`POST`	`/api/auth/logout`	`auth`	Logout
`GET`	`/api/dashboard`	`dashboard`
`GET`	`/api/dashboard/summary`	`dashboard`
`GET`	`/api/dashboard/activity`	`dashboard`
`GET`	`/api/dashboard/growth`	`dashboard`
`GET`	`/api/session/stats`	`dashboard`	Session stats endpoint - tracks activity from DB (includes MCP usage)
`GET`	`/api/feed`	`feed`
`POST`	`/api/feed`	`feed`	Log an event to feed.log
`GET`	`/api/graph`	`files`	Graph
`GET`	`/api/context`	`files`	Context
`GET`	`/api/file`	`files`	File - supports cross-repo access via ghq project paths
`GET`	`/api/read`	`files`
`GET`	`/api/doc/:id`	`files`
`GET`	`/api/logs`	`files`
`GET`	`/api/plugins`	`files`
`GET`	`/api/plugins/:name`	`files`
`GET`	`/api/threads`	`forum`	List threads
`POST`	`/api/thread`	`forum`	Create thread / send message
`GET`	`/api/thread/:id`	`forum`	Get thread by ID
`PATCH`	`/api/thread/:id/status`	`forum`	Update thread status
`GET`	`/api/health`	`health`	Health check
`GET`	`/api/stats`	`health`	Stats (extended with vector metrics)
`GET`	`/api/oracles`	`health`	Active Oracles — detected from existing activity across all log tables
`POST`	`/api/learn`	`knowledge`	Learn
`POST`	`/api/handoff`	`knowledge`	Handoff
`GET`	`/api/inbox`	`knowledge`	Inbox
`GET`	`/api/oraclenet/feed`	`oraclenet`	Feed — recent posts
`GET`	`/api/oraclenet/oracles`	`oraclenet`	Oracles directory
`GET`	`/api/oraclenet/presence`	`oraclenet`	Presence — recent heartbeats
`GET`	`/api/oraclenet/status`	`oraclenet`	Health check — is OracleNet reachable?
`GET`	`/api/plugins`	`plugins`
`GET`	`/api/plugins/:name`	`plugins`
`GET`	`/api/schedule/md`	`schedule`	Serve raw schedule.md for frontend rendering
`GET`	`/api/schedule`	`schedule`
`POST`	`/api/schedule`	`schedule`
`PATCH`	`/api/schedule/:id`	`schedule`	Update schedule event status
`GET`	`/api/search`	`search`	Search
`GET`	`/api/reflect`	`search`	Reflect
`GET`	`/api/similar`	`search`	Similar documents (vector nearest neighbors)
`GET`	`/api/map`	`search`	Knowledge map (2D projection of all embeddings)
`GET`	`/api/map3d`	`search`	Knowledge map 3D (real PCA from LanceDB bge-m3 embeddings)
`GET`	`/api/list`	`search`	List documents
`GET`	`/api/settings`	`settings`	Get settings (no password hash exposed)
`POST`	`/api/settings`	`settings`	Update settings
`GET`	`/api/supersede`	`supersede`	List supersessions from oracle_documents.superseded_by
`GET`	`/api/supersede/chain/:path`	`supersede`	Get supersede chain for a document (by source_file path)
`POST`	`/api/supersede`	`supersede`	Log a new supersession
`GET`	`/api/traces`	`traces`
`GET`	`/api/traces/:id`	`traces`
`GET`	`/api/traces/:id/chain`	`traces`
`POST`	`/api/traces/:prevId/link`	`traces`	Link traces: POST /api/traces/:prevId/link { nextId: "..." }
`DELETE`	`/api/traces/:id/link`	`traces`	Unlink trace: DELETE /api/traces/:id/link?direction=prev\	next
`GET`	`/api/traces/:id/linked-chain`	`traces`	Get trace linked chain: GET /api/traces/:id/linked-chain

References

TIMELINE.md - Full evolution history
docs/API.md - API documentation
docs/architecture.md - Architecture details
docs/CONTRIBUTING-AWAKENING.md - Where to post awakening announcements
Drizzle ORM
MCP SDK

🎯 aiskill88 AI 点评 A 级 2026-06-01

高质量的MCP工具，支持语义搜索

📚 实用指南（长尾问题）

适合谁

需要让 Claude / Cursor 操作本地工具的 AI 工程师
构建企业知识库 / RAG 检索应用的团队

最佳实践

配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据

常见错误

API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
容器内无法访问宿主机 localhost — 使用 host.docker.internal

部署方案

Docker：arra-oracle-v3 提供官方镜像，docker compose up 一键启动
CLI：直接 npm install -g / pip install，命令行调用
云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台

⚡ 核心功能

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

👥 适合谁

需要让 Claude / Cursor 操作本地工具的 AI 工程师
构建企业知识库 / RAG 检索应用的团队

⭐ 最佳实践

配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据

⚠️ 常见错误

API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
容器内无法访问宿主机 localhost — 使用 host.docker.internal

👥 适合人群

Claude Desktop / Claude Code 用户AI 工具开发者需要扩展 AI 能力的专业人士自动化工程师

🎯 使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

⚖️ 优点与不足

✅ 优点

+标准化 MCP 协议，生态互联性强
+与 Claude 官方生态无缝对接
+即插即用，配置简单快捷

⚠️ 不足

−依赖 Claude 客户端，非 Claude 用户无法使用
−MCP 协议仍在持续演进，接口可能变更
−需要一定的配置步骤

⚠️ 使用须知

该工具使用 NOASSERTION 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

📄 NOASSERTION — 请查阅原始协议条款了解具体使用限制。

🔗 相关工具推荐

基于Playwright的MCP协议服务器实现，提供浏览器自动化能力。支持网页交互、截图、数据采集等功能，适合开发者集成

Composio智能工具编排平台

MCP工具

📚 相关教程推荐

天涯社区重启：一个时代结束后，AI社区时代正在开始

Cursor AI 编程完全指南：Rules 配置、Composer 使用、MCP 集成

帮助中心 · AI Skill Hub

📰 相关 AI 新闻

AI 前沿资讯：How do you track AI costs toda…

🍿 AI 圈相关吃瓜

配了5个 MCP 工具，Claude 一个都没用

AI 圈观察

Filesystem MCP 帮 Claude 找文件，找了整个 node_modules

🗺️ 相关解决方案

ai-workflow-templates

🧩 你可能还需要

基于当前 Skill 的能力图谱，自动补全的工具组合

natively-cluely-ai-assistant — Claude Skill 中文使用文档

免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。

kb-arena是开源的AI工作流，用于Benchmark 9 retrieval architectures（向量、上下文、QnA、知识图

❓ 常见问题 FAQ

arra-oracle-v3 是什么工具？−

arra-oracle-v3 是一款TypeScript开发的AI辅助工具。开源MCP工具：Oracle v2 - MCP Memory Layer with semantic search, philosophy, and knowledge man。⭐69 · TypeScript 主要应用场景包括：知识管理和语义搜索。

arra-oracle-v3 如何安装和开始使用？+

arra-oracle-v3 是否免费？许可证是什么？+

arra-oracle-v3 适合哪些用户使用？+

arra-oracle-v3 的社区活跃度和项目维护状况如何？+

MCP 是什么？和普通 API 有什么区别？+

我需要编程基础才能使用这个 MCP 工具吗？+

这个工具支持 Claude Code 吗？还是只有 Claude Desktop？+

💡 AI Skill Hub 点评

经综合评估，MCP内存层在MCP工具赛道中表现稳健，质量良好。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。

⬇️ 获取与下载

📚 深入学习 MCP内存层

查看分步骤安装教程和完整使用指南，快速上手这款工具

⚙️ 安装教程 📚 使用教程

🌐 原始信息

原始名称	`arra-oracle-v3`
原始描述	开源MCP工具：Oracle v2 - MCP Memory Layer with semantic search, philosophy, and knowledge man。⭐69 · TypeScript
Topics	`mcptypescriptsemantic search`
GitHub	https://github.com/Soul-Brews-Studio/arra-oracle-v3
License	NOASSERTION
语言	TypeScript

🔗 原始来源

🐙 GitHub 仓库 https://github.com/Soul-Brews-Studio/arra-oracle-v3

收录时间：2026-06-01 · 更新时间：2026-06-02 · License：NOASSERTION · AI Skill Hub 不对第三方内容的准确性作法律背书。

MCP内存层

📚 深度解析

📋 工具概览

📖 中文文档

Arra Oracle - MCP Memory Layer

Install

Configuration

CLI (operator client)

Vault CLI (secondary bin — use --package)

API Endpoints

References

⚡ 核心功能

👥 适合人群

🎯 使用场景

⚖️ 优点与不足

🔗 相关工具推荐

❓ 常见问题 FAQ

🤖 交给 Agent 安装 · MCP内存层