stylechart

stylechart

ごく普通の一文で気分を表すと、stylechart が、それに結び付くビジュアルスタイルを教えてくれます。その仕組みは、感情を表す言葉とビジュアルスタイルという二層の語彙集と、それらを結ぶリンクです。口語的な一文を入力すると、最もよく一致するスタイルと、一致の根拠となった感情を表す言葉が返ってくるため、スタイル名だけでなく、なぜそのスタイルが選ばれたのかも確認できます。

stylechart は、https://xiximm.cloud でホストされている、公開済みの感情検索 REST API（v2）の直接クライアントです。語彙集とマッチング処理はサーバー側で行われます。このパッケージは引数を検証し、無料のエンドポイントを呼び出して、JSON をそのまま返します。

5 つのツール：

• word_analyze — 1 文（最大 500 文字）を入力すると、最もよく一致するビジュアルスタイルと、その根拠となる感情を表す言葉を返します。words（1～12）と styles（1～30）を指定すると、返す各項目数に上限を設定できます。語彙集にない表現の場合、単語リストは空で返ります。これはエラーではなく、想定どおりの動作です。
• word_lookup — 感情を表す単語 1 つの詳細情報を返します。定義、類義語、関連するスタイルが含まれます。
• word_list — 語彙集全体を 1 回の応答で返します。query を指定すると、辞書がローカルで絞り込まれます。テキストにクエリを含む単語と、名前または ID にクエリを含むスタイルが対象になり、絞り込み後と全体の件数が並べて表示されます。
• style_get — ID でスタイルを 1 つ取得します（例：synthwave）。定義、親スタイル、メンバーの単語、参照画像が含まれます。
• word_status — 語彙集の網羅状況のみを返します。辞書の応答のうち {ok, counts} の部分を取得し、テーブル全体をダウンロードせずにデータが最新か確認できます。

無料エンドポイントのみ

この再構築版は、公開済みの無料エンドポイント（POST /v2/analyze、GET /v2/links、GET /v2/dictionary、GET /v2/styles/<id>）のみを呼び出します。有料のクラウド経路はサポートされていません。いかなる支払い機能もなく、購入済みのクォータトークンにも対応していません（X-FS-Quota ヘッダーは送信されません）。また、従量課金制の画像エンドポイントも呼び出しません。上流側の /v2/analyze が HTTP 402 を返した場合、stylechart は支払いを行わず、有料経路を示すエラーとして報告します。

設定

• FEELING_API_BASE — API のベース URL です。既定値は https://xiximm.cloud です。API キーは不要で、受け付けていません。

CLI

各ツールは、JSON 引数文字列を 1 つ取るサブコマンドです（word_status は引数不要で、word_list の引数は省略できます）。

npx @reneturcios/stylechart word_analyze '{"text":"rainy neon streets at night","styles":5}'
npx @reneturcios/stylechart word_lookup '{"word":"melancholy"}'
npx @reneturcios/stylechart word_list '{"query":"neon"}'
npx @reneturcios/stylechart word_list
npx @reneturcios/stylechart style_get '{"id":"synthwave"}'
npx @reneturcios/stylechart word_status
npx @reneturcios/stylechart --version

出力はツールの結果を示す JSON です。終了コード：成功時は 0、実行時エラー（検証エラーまたは上流側の障害を含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/stylechart mcp

MCP クライアントの設定：

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

Docker

docker run -i ghcr.io/cloudcorprecords/stylechart
docker run --rm ghcr.io/cloudcorprecords/stylechart word_status

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios