インストール

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

Node.js 22+ が必須

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

Claude Code

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

確認:

claude mcp list

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

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

toml

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

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

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`

json

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

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

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

npx -y @libraz/formulon-mcp

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

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

用語: stdio MCP server

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

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

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 です。

低コストな smoke test として推奨です。