Cedulon

@cedulon/mcp-server

ローカルの stdio MCP サーバーです。@cedulon/core、 @cedulon/x402-adapter、@cedulon/audit、@cedulon/receipts を薄くラップします。 ワークスペース外の実行時依存関係は、公式 MCP SDK のみです。

コアパッケージには、引き続き実行時依存関係がありません。このパッケージが依存するのは、 これらのワークスペースパッケージと @modelcontextprotocol/sdk のみです。

ツール

名前	説明
cedulon_spend	ポリシーで制御される支出です。引数：amount、currency、payee、nonce、tool。許可された場合は署名済みのレシート JSON を返します。拒否された場合は { ok: false, reason } を返します。
cedulon_audit	レシートチェーンを決済レールの抽出データと照合します。照合対象は、プロセス内台帳、または extract として渡された署名済みの抽出データです。省略可能な extraSettlements では抽出データの行を追加できます（デモを迂回するため、extract と同時に指定すると拒否されます）。提示された抽出データを対象に実行した場合、結果には scope が含まれます。また、各レシートと行が分類されたクラスを示す counts も含まれます。
cedulon_verify_receipt	レシートの COSE バイト列（receipt オブジェクト、または coseHex + publicKeyPem）を検証します。カウンター署名がある場合は、それも確認します。
cedulon_export_ledger	レシート、チェックポイント、抽出データを demo:export JSON 形式で出力します。調査結果、保証内容、およびこのサーバー独自の台帳に対する監査の counts も含まれます。
cedulon_status	バージョン、ポリシーの概要、レシート数、チェーンヘッドを表示します。

実行

バイナリは cedulon-mcp です（コンパイル済み JavaScript のため、 --experimental-strip-types は不要です）。このリポジトリで npm run build:packages を実行した後：

node packages/mcp-server/dist/index.js

クローンせずに公開済みパッケージから実行する場合：

npx -y @cedulon/mcp-server

npx cedulon-mcp は、パッケージ化済みまたはインストール済みのコピーから同じバイナリを実行します。 このサーバーは MCP Registry に io.github.dogrucanemek-alt/cedulon としても登録されています。

リポジトリのソースツリーから実行する場合（開発用）：

npm run mcp

ホストの設定

パッケージをインストールした後の Claude Desktop / Claude Code / Cursor（mcpServers）の設定：

{
  "mcpServers": {
    "cedulon": {
      "command": "npx",
      "args": ["-y", "@cedulon/mcp-server"]
    }
  }
}

状態とポリシー

デフォルトではプロセス内で動作します。CEDULON_STATE_PATH に JSON ファイルを指定すると、プロセスの再起動後もレシート、チェックポイント、抽出データの行、デモ用キーを保持できます。 このファイルをコミットしないでください。

ポリシー設定（括弧内はデモ用のデフォルト値）：

• CEDULON_MAX_AMOUNT（10）
• CEDULON_MAX_CUMULATIVE（30）
• CEDULON_MAX_PAYMENTS（3）
• CEDULON_WINDOW_MS（3600000）
• CEDULON_ALLOWED_PAYEES（payee-1；* ですべての制限を解除）
• CEDULON_ALLOWED_CURRENCIES（USD；* ですべての制限を解除）
• CEDULON_ALLOWED_TOOLS
• CEDULON_PAYER（payer-1）

決済レールはプロセス内のモックです。ウォレットも RPC もネットワークも使用しません。

プライバシーポリシー

https://cedulon.com/privacy.html

このページに詳しく記載されている内容の要約です。このサーバーはお使いのマシン上で動作し、stdio を介してクライアントと通信します。ネットワークリクエストは一切行いません。このパッケージと依存する 6 つのパッケージには HTTP クライアント、ソケット、テレメトリーが含まれておらず、プロジェクト外の依存関係は公式 Model Context Protocol SDK のみです。収集先となる当社のエンドポイントがないため、情報を収集することもありません。

動作中は、セッションの支出リクエスト（金額、通貨、支払先、nonce、呼び出し元のツール名）、それらから作成されたレシート、チェックポイント、ポリシーの上限値をメモリ上に保持します。CEDULON_STATE_PATH を設定しない限り、ディスクには何も書き込みません。設定した場合は、選択したパスに台帳を JSON 形式で、お使いのマシン上に書き込みます。分析、クラッシュレポート、アップデート確認、第三者との共有はありません。

プライバシーに関する質問やセキュリティ報告は [email protected] までお寄せください。