Archcore MCP

Archcore CLI — 以 Git 為本、專為 AI 編碼代理打造的上下文層

Archcore 已遷移至 github.com/archcore-ai/archcore。 本儲存庫已封存。CLI 現位於該儲存庫中的 cli/，與外掛程式並列，且自 v0.10.1 起的每個版本皆發布於 archcore-ai/archcore/releases。 在 macOS、Linux 與 WSL 上，請使用 curl -fsSL https://archcore.ai/install.sh | bash 安裝或更新；在 Windows 上則使用 irm https://archcore.ai/install.ps1 | iex。從本儲存庫安裝的二進位檔（v0.8.7 或更早版本）不再自動更新；請執行一次安裝程式以切換至新管道。問題回報請至：archcore-ai/archcore/issues。

Archcore 是專為 AI 編碼代理打造的、以 Git 為本的上下文層。

這款 CLI 將規格、架構決策、規則、計畫與專案知識保存在 .archcore/ 中，與你的程式碼一同進行版本控管，並透過 MCP 與工作階段鉤子（session hooks）將相關上下文提供給編碼代理。

它以 CLI 與本機 stdio MCP 伺服器的形式發布，因此任何相容 MCP 的編碼代理都能透過標準工具讀取與寫入你的專案上下文。可用於在 Claude Code、Cursor、Codex CLI、GitHub Copilot、Gemini CLI、OpenCode、Roo Code 與 Cline 之間維持持久的專案上下文。

實際運作示範

那段上下文來自 .archcore/ —— 以 Git 進行版本控管的 Markdown 文件，透過 MCP 工具與工作階段鉤子提供給任何代理。

有何不同

❌ 沒有 Archcore

每次工作階段都從零開始。代理會：

• 猜測你的架構並破壞你的慣例
• 重複已存在的邏輯
• 重新爭論你的團隊早已做出的決策
• 每次對話都需要重新解釋相同的上下文

✅ 有了 Archcore

你的決策、規則與慣例以結構化上下文的形式存在於 Git 中。代理會：

• 在工作階段開始時載入適用的決策與規則
• 將程式碼放在你的架構所指定的位置
• 尊重儲存庫中既有的 ADR、規格與規則
• 將新決策記錄為持久上下文——可在 PR 中審查，並可跨代理移植

代理不再猜測，而是開始遵循系統。

60 秒快速上手

curl -fsSL https://archcore.ai/install.sh | bash    # macOS / Linux
cd your-project && archcore init

archcore init 會建立 .archcore/、偵測你的編碼代理，並為它們設定鉤子與 MCP。

接著開啟你的代理並說：

「我們主要使用 PostgreSQL 作為儲存。請記錄這項決策。」

完成——現在 .archcore/ 中已有一份結構化的 ADR，未來任何代理的任何工作階段都會看到它。

在 Windows 上：irm https://archcore.ai/install.ps1 | iex。至於 WSL、go install 與從原始碼建置，請參閱下方的 安裝方式 或完整安裝指南。

與你的代理相容

這款 CLI 本身就是一個本機 stdio MCP 伺服器——為所有相容 MCP 的代理提供單一整合介面。鉤子則在代理支援時，於工作階段開始時加入上下文。

archcore init 會自動設定偵測到的代理。若要手動設定一個：

archcore mcp install --agent cursor      # write MCP config for a specific agent
archcore hooks install                   # install session-start hooks for detected agents
claude mcp add --transport stdio archcore -- archcore mcp   # or add the server manually

運作方式

1. 初始化 — archcore init 會建立 .archcore/ 並安裝代理整合。
2. 擷取 — 決策、規則、計畫與指南會以帶有 YAML frontmatter 的 Markdown 文件形式儲存。
3. 重用 — 代理在作業時可透過 MCP 工具讀取、建立、更新與連結文件；鉤子則在工作階段開始時載入上下文。
4. 保留在 Git 中 — 像審查程式碼一樣審查上下文變更、隨時間演進，並保持跨工具的可移植性。

.archcore/
├── settings.json
├── auth/
│   ├── jwt-strategy.adr.md
│   └── auth-redesign.prd.md
├── backend/
│   └── error-wrapping.rule.md
├── incidents/
│   └── connection-pool-exhaustion.cpat.md
└── notifications/
    └── notifications-implementation.plan.md

結構是自由形式的——可按領域、功能或團隊組織。文件的類型存在於其檔名中（slug.type.md）：橫跨三個層級共 23 種類型——知識（ADR、規則、規格、指南）、願景（PRD、計畫、想法、需求軌道）與經驗（事件模式、重複性任務）。本儲存庫自身的 .archcore/ 就是一個實際範例。

詢問你的代理

「在我動 auth 模組之前，這裡適用了哪些決策與規則？」

在代理編輯任何一行程式碼之前，先載入與該區域相關的 ADR 與規則。

「我們有個慣例：一律用 fmt.Errorf 與 %w 包裝錯誤。把這設為規則。」

建立 backend/error-wrapping.rule.md，內容包含命令式指引、理由與好／壞範例。

「上週我們發生了一次連線池耗盡事件。請記錄下來，避免重蹈覆轍。」

建立 incidents/connection-pool-exhaustion.cpat.md，內容包含根本原因分析與預防步驟。

比較

不適用於——聊天記憶、提示詞庫，或一次性規格轉程式碼生成器。Archcore 是編碼代理的儲存庫真相層，而非方法論套件。

參考資料

隨附內容：23 種文件類型、7 種關聯類型、10 個 MCP 工具、4 個代理的鉤子整合與 8 個代理的 MCP 整合。

---
title: "Use PostgreSQL for Primary Storage"
status: draft
tags: [database, infrastructure]
---

## Context

...

curl -fsSL https://archcore.ai/install.sh | bash

irm https://archcore.ai/install.ps1 | iex

go install github.com/archcore-ai/cli@latest

git clone https://github.com/archcore-ai/cli.git
cd cli
go build -o archcore .

archcore config                    # show all settings
archcore config get <key>          # get a specific value
archcore config set <key> <value>  # set a value

生態系統

• Archcore 外掛程式 — 使用 Claude Code 或 Cursor？此外掛程式與 CLI 搭配：相同引擎，加上技能、意圖指令與護欄。一個產品、兩個入口——單獨使用 CLI 即可涵蓋所有其他代理程式。
• docs.archcore.ai — 完整文件。
• 此儲存庫中的 .archcore/ — 一個實際範例：CLI 使用自己的上下文層建置。

開發

需要 Go 1.25+。

go build -o archcore .   # build
go test ./...            # run all tests

連結與授權

• 文件： docs.archcore.ai
• 網站： archcore.ai
• 外掛程式（Claude Code、Cursor）： github.com/archcore-ai/plugin
• 問題回報： github.com/archcore-ai/cli/issues
• 授權： Apache 2.0