Archcore MCP

Archcore CLI — Git 原生上下文，面向 AI 编程代理

Archcore 是面向 AI 编程代理的 Git 原生上下文层。

该 CLI 将规范、架构决策、规则、计划和项目知识保存在 .archcore/ 中，与代码一起版本化，并通过 MCP 和会话钩子向编程代理提供相关上下文。

它作为 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）：跨三个层的 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 个代理的钩子集成以及针对 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