インストール

formulon-mcp は npm に公開されており、npx 経由で改変なしに動きます。大半の MCP クライアントは 1 行の登録で済みます。

Node.js 22+ が必須

サーバーは Node 22 の機能を使います。それ以前のバージョンは起動に失敗します。node --version で確認してください。

Claude Code

claude mcp add --scope user formulon -- npx -y @libraz/formulon-mcp

確認:

claude mcp list

formulon が ✓ Connected と表示されれば成功です。ログやトラブルシュートは Claude Code 公式ドキュメント を参照してください。

プロジェクトスコープ

上記のコマンドは --scope user を使うため、すべてのプロジェクトに対して formulon を登録します。特定のリポジトリだけに絞りたい場合は、プロジェクトルートに .mcp.json を作成してください。

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

Claude Code はそのディレクトリで開いたセッションで .mcp.json を自動的に読み込みます。claude mcp add を実行する必要はありません。後述のインタラクティブセットアップでもこのファイルを生成できます。

Codex CLI

~/.codex/config.toml に以下を追加します。

[mcp_servers.formulon]
command = "npx"
args = ["-y", "@libraz/formulon-mcp"]

codex を再起動するとツール検出に出てきます。

Claude Desktop

claude_desktop_config.json に formulon を追加します。OS ごとの場所は次のとおりです。

OS	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

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

Claude Desktop を再起動すると次のセッションからツールが使えるようになります。

インタラクティブセットアップ

設定ファイルを手で編集する代わりに、formulon を 1 つ以上のクライアントに登録（または削除）するインストーラが同梱されています。

npx -y @libraz/formulon-mcp init

カンマ区切りで 1 つ以上の対象を選べます。

1. Claude Code — user (~/.claude.json)
2. Claude Code — project (./.mcp.json)
3. Codex CLI (~/.codex/config.toml)
4. Claude Desktop（OS ごとのパスは上記参照）

書き込み前に各ファイルへの変更内容（新規 / マージ / 既存の formulon エントリを置換）をプレビューし、同じファイル内の他のサーバー設定には触れません。反映にはクライアントの再起動が必要です。

エントリを削除するには:

npx -y @libraz/formulon-mcp uninstall

対象メニューは同じです。formulon エントリが存在しない対象はそのまま残ります。

その他の stdio MCP クライアント

stdio 対応の MCP クライアントはすべて使えます。起動コマンドを次のいずれかに向けてください。

npx -y @libraz/formulon-mcp

グローバルインストール済みなら:

npm install -g @libraz/formulon-mcp
formulon-mcp

用語: stdio MCP server

クライアントが子プロセスとして起動し、stdin / stdout で JSON-RPC を話す長期実行プロセスです。プロセスのライフタイムはクライアントが所有し、親を終了すればサーバーも止まります。ポートは開きません。

ソースから

開発中の fork や特定 revision を固定する場合:

git clone https://github.com/libraz/formulon-mcp.git
cd formulon-mcp
yarn install
yarn run build

ビルド済み dist/index.js の絶対パスを登録します。

claude mcp add --scope user formulon node /absolute/path/to/formulon-mcp/dist/index.js

clone せずに最新 main を試すなら:

npx -y github:libraz/formulon-mcp

動作確認

接続済みクライアントから次の 2 ツールが使えれば疎通 OK です。

• formulon_version ─ ロード済み Formulon エンジンのバージョン
• formulon_eval_formula ─ 使い捨てワークブックで 1 つの数式を評価

低コストなスモークテストとして推奨です。

次に読むもの

• ワークフロー ─ open / mutate / recalc / save の流れ
• ツール一覧 ─ カテゴリ別のツール一覧
• セキュリティモデル ─ サーバーが許可すること / しないこと