archstone

Archstone — あらゆる AI をビジネスにつなぐ

AI 機能のコンパイラーです。 ビジネスで何ができるのかを、ビジネス用語で一度記述します。 Archstone はその記述を、AI エージェントが検出して呼び出せるツールにコンパイルします。現在は MCP に対応しており、今後ほかのプロトコルにも対応します。 統合コードを手書きする必要はありません。

オープンソース、Apache-2.0。

必要な情報を探す

知りたいこと	移動先
60 秒で動作を確認する	試してみる
OpenAPI 仕様からマニフェストを生成する	既存の API を起点にする
CLI をインストールして各コマンドの内容を確認する	インストール · コマンド
モデルを理解する（CDL → IR → ツール）	仕組み
独自のエージェントループから機能を呼び出す	組み込む
Archstone の保証内容を確認する	保証内容
言語を学ぶ	CDL 仕様 · 用語集
最初から最後まで順を追って確認する	オンボーディングガイド
無料の範囲と販売対象を確認する	オープンソースと商用利用
貢献する	貢献

---

試してみる — 60 秒、インストール不要

Archstone でコンパイルされた機能が、ライブで稼働しています。

https://demo.archstone.dev/mcp

• Claude アプリ（ウェブ、デスクトップ、またはモバイル）：設定 → コネクター → カスタムコネクターを追加 → URL を貼り付けて、旅行について質問します。Free プランで利用できます。

• Claude Code：

  claude mcp add --transport http archstone-tourism https://demo.archstone.dev/mcp
  

読み取り専用のツールにキーは必要ありません。デモの予約ツールにはキーが必要です。2 つの公開キーはショーケースに記載されています。キーを送信するには、名前と URL の後にヘッダーを指定してサーバーを追加します（--header は後続のすべての語を受け取るため、前に配置するとそれらも取り込みます）。

claude mcp add --transport http archstone-tourism https://demo.archstone.dev/mcp \
  --header "Authorization: Bearer <key>"

この統合の基盤となるのは、12 行のビジネス YAMLだけです。HTTP も JSON Schema も MCP SDK も必要ありません。それ以外はすべて自動生成されました。

自社システムで試してみませんか？[email protected]。

既存の API を起点にする

archstone init openapi.yaml --out manifest --company acme --domain catalog

init は OpenAPI ドキュメントからマニフェストの草案を作成し、仕様では答えられないことを質問します。コンパイルに成功しない限り、何も書き込みません。

詳細：オンボーディング → archstone init。 録画で使われている仕様は examples/demo/stays-openapi.yaml です。

---

インストール

npm install -g @archstone/cli     # or: npx @archstone/cli <command>

Node 22 以降が必要です。マニフェストは独自のリポジトリに置きます。CLI はステートレスなコンパイラーのため、このリポジトリをチェックアウトする必要はありません （理由）。

コマンド

コマンド	内容
archstone init <openapi>	OpenAPI ドキュメントからマニフェストのドラフトを作成します（または、--source postgres --dsn-env <VAR> を指定して Postgres カタログから作成します）
archstone apply <dir>	検証して IR にコンパイルします。--exposure を指定すると、モデルに見えるものと決して見えないもの、および公開、非公開、未公開（廃止済み、未バインド）の機能がわかります
archstone build <dir>	埋め込み用のポータブル IR アーティファクトを書き出します
archstone serve <dir>	MCP ツールを stdio 経由で提供します。HTTP の場合は --http --token <t> を指定します
archstone verify <dir>	記録されたフィクスチャを実際のバックエンドに対して再生し、差異を報告します。CI 用には --json を指定します
archstone doctor <dir>	オフラインで実行する、本番環境導入前のチェックリストです
archstone adopt <dir>	バックエンドが返すようになったフィールドを宣言します（対話式）
archstone audit <log>	実行監査証跡を読み返します

apply は、irreversible 機能にまだ不足しているものについても警告します。ここでは、宣言された失敗を削除すると警告が表示され、元に戻すと警告が消えます。

各コマンドについては、オンボーディングガイドで説明しています。 このリポジトリをチェックアウトして作業する場合は、pnpm apply、pnpm serve などを使用してください。貢献者向けオンボーディングを参照してください。

---

仕組み

capabilities.yaml   →   *.capability.yaml   →   bindings/*.binding.yaml
(what the company      (each capability:        (how a capability maps
 offers — the index)    business shape only)     to a real backend)

        └──────── archstone apply ────────┘        └── archstone serve ──┘
             parse → validate → compile → IR          emit MCP tools → agent

• CDL（Capability Definition Language）は、提供するものの「内容」を業務用語だけで記述します。
• バインディングは、各機能がバックエンド（REST または SQL）に接続する「方法」を示します。 SQL コネクターガイドでは、Postgres の例を解説しています。
• コンパイラーは両方をターゲット非依存の IR に変換し、エミッターは IR からツールを生成します。

プロトコルを変更した場合は、書き直すのではなく再生成します。バックエンドを変更しても、CDL は変わりません。実例については、examples/manifests/booking/を参照してください。

独自のエージェントに埋め込む

MCP サーバーのプロセスは必要ありません。ビルド済みの IR を @archstone/agentで読み込みます。

import { fromIR } from "@archstone/agent";

const archstone = fromIR(compiledIR);
const tools = archstone.tools("anthropic"); // or "openai-chat", "openai-responses", "gemini", "json-schema"
const result = await archstone.execute("tourism.search", { location: "Paris" });

マウント可能な Streamable-HTTP MCP ハンドラーは @archstone/agent/mcp で利用できます。API の全容については、packages/agentを参照してください。

保証

以下は実装の詳細ではなく、承認済みの決定事項です。それぞれの項目から、その根拠を確認できます。

保証	決定事項
マニフェストで宣言されていないプロバイダーフィールドがモデルに届くことはありません	ADR-0008
モデルが作り出したフィールドがシステムに届くことはありません	ADR-0011
build と serve では、ネットワーク接続、アカウント、キーが不要です	ADR-0005
現在無料の機能が有料になることはありません	ADR-0005
Archstone が行う選択における順位付けは、いかなる場合も販売対象ではありません	ADR-0006
effect（read／write／irreversible）は人が確認し、自動で推測されることはありません	オンボーディング

すべての決定記録： docs/adr/。

---

利用している組織

カスタム額装事業を営む ArtVinci は、Archstone でコンパイルされた機能を通じて顧客からの質問に回答しています。実際のカタログを参照し、価格は自社のバックエンドでリアルタイムに計算されます。導入事例。

MCP サーバーではなく、コンパイラーを使う理由

最初の MCP サーバーは、半日もあれば作れます。本当のコストがかかるのは5つ目のサーバーです。ChatGPT、Gemini、そして次に登場するものはそれぞれ少しずつ異なる形をしており、その土台となる API も変わり続けます。Archstone はコンパイラーであり、最初のリリースでは MCP サーバーを生成するため、新しいプロトコルが登場するたびにメンテナンスの負担が増えることはありません。

オープンソースと商用

マニフェストをエージェントが呼び出せるものに変換するために必要なもの、つまり言語、コンパイラー、IR、エミッター、組み込み SDK、CLI はすべて Apache-2.0 であり、今後もそのままです。販売するのは、お客様に代わって運用するサービスです。ホスト型の監査ログ保管、マネージドレート制限、ドリフト監視、マルチテナントホスティングを提供します。ADR-0005 をご覧ください。

---

ドキュメント

トピック	場所
オンボーディング（プロバイダー、組み込み担当者、コントリビューター）	docs/ONBOARDING.md
CDL 仕様（規範的、1.0、凍結済み）	docs/cdl-specification.md
CDL がこのような形になっている理由	RFC-0002
機械可読スキーマ	cdl.schema.json
用語集	docs/glossary.md
ID とプリンシパル	docs/IDENTITY.md
アーキテクチャ上の決定事項	docs/adr/
バックエンドとしての Postgres データベース（sql コネクター）	docs/guides/sql-connector.md
Claude を使ったエンドツーエンドのデモ	examples/demo/README.md
サポート対象バージョン	SUPPORT.md
脆弱性の報告	SECURITY.md — 公開 issue では報告しないでください
変更履歴	CHANGELOG.md

リポジトリの構成

packages/
  schema/           load and shape-validate manifests (cdl.schema.json)
  compiler/         semantic validation, lowering to IR
  emitter-support/  shared substrate for every emitter
  runtime/          registry, MCP emitter and transport, verify
  agent/            embedded SDK
  init/             OpenAPI → manifest drafting
  cli/              the archstone command
providers/
  rest/  sql/       backend adapters
examples/           manifests and the Claude demo
docs/               spec, ADRs, RFCs, onboarding

---

このプロジェクトでの生成 AI の活用方法

Archstone は、実装、テスト、ドキュメント作成において、Claude Code を通じた Anthropic の Claude による多大な AI 支援を受けて開発されています。**決定事項が生成されることはありません。**構造上の選択はすべて ADR として記録され、コードが書かれる前に責任を持つ人が議論し、承認します。また、誰も説明できないパッチがマージされることはありません。生成コードを含むコミットでは、共著者トレーラーにモデル名を記載します。コントリビューターにお願いすることは、CONTRIBUTING.md に記載されています。

コントリビューション

CONTRIBUTING.md とコントリビューター向けオンボーディングをご覧ください。Node 22 以上、pnpm 11 以上が必要です。PR を作成する前に、pnpm typecheck && pnpm test が成功することを確認してください。

ライセンス

Copyright 2026 NousVigil LLC. Apache-2.0 のもとでライセンスされています。NOTICE もご覧ください。