Archcore MCP

Archcore CLI — 面向 AI 编码代理的 Git 原生上下文

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 和会话钩子向编码代理提供相关上下文。

它以 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