Archcore MCP

Archcore CLI — 為 AI 編碼代理打造的 Git 原生脈絡層

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 工具和 session hooks 提供給任何代理。

改變了什麼

❌ 沒有 Archcore

每次會話都從零開始。代理會：

• 猜測你的架構並破壞你的慣例
• 重複已經存在的邏輯
• 重新爭論你的團隊已經做過的決定
• 每次對話都需要重新解釋相同的脈絡

✅ 有了 Archcore

你的決定、規則和慣例以結構化脈絡的形式存在於 Git 中。代理會：

• 在會話開始時載入適用的決定和規則
• 把程式碼放在你的架構指定的位置
• 尊重儲存庫中已有的 ADR、規格和規則
• 將新決定記錄為持久的脈絡——可在 PR 中審查，可跨代理移植

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

60 秒快速開始

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

archcore init 建立 .archcore/ 骨架、偵測你的編碼代理，並為它們接上 hooks 和 MCP。

然後打開你的代理並說：

"我們使用 PostgreSQL 作為主要儲存。請記錄這個決定。"

完成了——現在 .archcore/ 中有一份結構化的 ADR，未來在任何代理中的每次會話都會看到。

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

與你的代理相容

CLI 本身就是一個本機 stdio MCP 伺服器——為每個相容 MCP 的代理提供單一整合介面。Hooks 在代理支援的地方加入會話開始時的脈絡。

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 工具讀取、建立、更新和連結文件；hooks 在會話開始時載入脈絡。
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）中：涵蓋三個層級的 19 種類型——知識（ADR、規則、規格、指南）、願景（PRD、計畫、想法、需求軌道）和經驗（事件模式、重複任務）。此儲存庫自身的 .archcore/ 就是一個實際運作的範例。

詢問你的代理

"在我動認證模組之前，這裡適用哪些決定和規則？"

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

"我們有個慣例：總是用 fmt.Errorf 和 %w 包裝錯誤。把這個訂成規則。"

建立 backend/error-wrapping.rule.md 並帶有命令式指引、理由以及好/壞範例。

"上週我們發生了一次連線池耗盡事件。把它記錄下來，以免重蹈覆轍。"

建立 incidents/connection-pool-exhaustion.cpat.md 並帶有根因分析和預防步驟。

比較

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

參考資料

內含內容：19 種文件類型、4 種關聯類型、10 個 MCP 工具、4 個代理的 hook 整合以及 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 Plugin — 使用 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/archcore-plugin
• 問題回報： github.com/archcore-ai/cli/issues
• 授權： Apache 2.0