ArcSync

Name: ArcSync
Author: VanLandinghamLabs

本地服务

arcsync.dev云与基础设施01 天前更新

代码仓库访问官网

关于 ArcSync

ArcSync 是面向编码 Agent 的 MCP 服务，可将基础设施即代码转换为架构图。它支持多种 IaC 格式，并允许 Agent 检查、比较和发布图表。

主要功能

01解析 Terraform、CDK、CloudFormation、Pulumi、ARM 和 Serverless Framework
02列出图表和版本
03检查资源及基础设施变更
04验证并发布 Agent 编写的图表

适用场景

01查看 IaC 项目生成的架构
02审查不同基础设施版本间的变更
03发布带画布链接的 Agent 图表

MCP 相关

它通过解析、检查、验证和发布等工具，向 MCP 客户端提供 ArcSync 架构图及图表操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "vanlandinghamlabs-arcsync": {
      "command": "npx",
      "args": [
        "-y",
        "arcsync-mcp"
      ],
      "env": {
        "ARCSYNC_CLIENT_ID": "<ARCSYNC_CLIENT_ID>",
        "ARCSYNC_CLIENT_SECRET": "<ARCSYNC_CLIENT_SECRET>"
      }
    }
  }
}

启动命令npx -y arcsync-mcp

需要配置的环境变量

ARCSYNC_CLIENT_IDMCP credential client ID for CI or shared machines; omit to connect in the browser

ARCSYNC_CLIENT_SECRET密钥MCP credential secret, paired with ARCSYNC_CLIENT_ID

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmarcsync-mcp0.3.9stdio

工具

收录的工具列表 · 更新于今天

参数	类型	必填	说明
limit	integer	否	最大行数（默认 25）。
query	string	否	不区分大小写的子字符串筛选器。

详细介绍

arcsync-mcp

一个 MCP 服务，可让编码 Agent（Claude Code、Cursor、GitHub Copilot 和其他 MCP 客户端）使用从基础设施即代码解析出的架构图 ArcSync：Terraform、AWS CDK、CloudFormation、Pulumi、Azure ARM 和 Serverless Framework。

工具：list_diagrams、get_diagram（Mermaid 或 JSON 格式，另附画布链接）、describe_resource、get_delta、list_versions、start_parse、get_parse_status。对于由 Agent 自行编写的图表，可使用：validate_diagram（本地检查）、push_diagram（保存图表并获取画布和 Notion 嵌入链接）、get_diagram_source、list_icons。

设置

添加到 .mcp.json（其中不包含凭据，因此可以安全提交）：

{
  "mcpServers": {
    "arcsync": {
      "command": "npx",
      "args": ["-y", "arcsync-mcp"]
    }
  }
}

Claude Desktop

从最新的发布版本下载 arcsync-mcp-<version>.mcpb 并打开：Claude Desktop 会安装扩展，无需编辑配置文件。将两个凭据字段留空，即可通过浏览器连接（见下文）；也可以在 Settings 中填写 MCP 凭据。

无需 Node.js

每个发布版本也会提供独立二进制文件。在 macOS 或 Linux 上，可通过 Homebrew 安装（在 Intel Mac 上，Homebrew 会使用其自带的 Node.js 安装 npm 包）：

brew install vanlandinghamlabs/tap/arcsync-mcp

在 Windows 上，或未安装 Homebrew 时，请从 Releases 下载适用于你平台的压缩包，并使用 gh attestation verify <archive> -R VanLandinghamLabs/arcsync-mcp 进行验证。然后使用 "command": "arcsync-mcp"，不带 args；并使用 arcsync-mcp login / logout 替代下文中的 npx 命令。

此服务已在 MCP Registry 中登记，名称为 io.github.VanLandinghamLabs/arcsync-mcp。

连接

首次调用工具时会返回一个指向 https://arcsync.dev/settings/mcp/connect 的链接。打开链接、登录并点击 Connect：ArcSync 会生成 MCP 凭据，并通过 127.0.0.1 将其交给服务；服务会将凭据保存到 ~/.config/arcsync/mcp-credential.json（模式为 0600），并从下一次调用开始使用。也可以在终端中运行 npx -y arcsync-mcp login 完成相同操作；运行 npx -y arcsync-mcp logout 可删除已保存的文件。

对于 CI 或共享机器，请改为在 https://arcsync.dev/settings 创建 MCP 凭据，并在服务的环境中传入 ARCSYNC_CLIENT_ID 和 ARCSYNC_CLIENT_SECRET；它们的优先级高于已保存的凭据。

skills/ 目录中提供了两项 Agent 技能：arcsync-mcp 会告知 Agent 何时调用各个图工具；arcsync-diagrams 会教 Agent 编写、验证并推送自己的图表。通过 skills CLI 为 Claude Code、Codex、Cursor 和其他受支持的 Agent 安装这两项技能：

npx skills add VanLandinghamLabs/arcsync-mcp

这些技能不会安装服务；请按上述说明添加服务。

完整指南：https://arcsync.dev/docs/mcp

源码与开发

本仓库会在每次发布时从 ArcSync 单体仓库镜像而来，同时包含服务所用的 ArcSync 核心模块（vendor/core/）。发布版本会从此处通过 provenance 发布到 npm，因此 npm view arcsync-mcp --json 会将每个版本关联到构建它的提交和工作流运行记录。欢迎提交问题和拉取请求；被接受的更改会移植到单体仓库，并在下一版本中发布。

npm ci
npm test
npm run build            # dist/index.js, one self-contained file
npm run eval:diagrams    # arcsync-diagrams skill evals; after build, costs model calls