Excel To JSON MCP By WTSolutions

WTSolutions の Excel to JSON MCP

中文

はじめに

Excel to JSON MCP（Model Context Protocol）は、Model Context Protocol を使用して Excel および CSV データを JSON 形式に変換するための標準インターフェースを提供します。この MCP 実装では、データ変換用に次の 2 つのツールを提供します。

• excel_to_json_mcp_from_data：タブ区切りの Excel データまたはカンマ区切りの CSV テキストデータを JSON 形式に変換します。
• excel_to_json_mcp_from_url：指定された URL の Excel ファイル（.xlsx）を変換します。

Excel to JSON MCP は、WTSolutions の Excel to JSON の一部です。

• Excel to JSON Web App：ウェブブラウザーで Excel を JSON に直接変換します。
• Excel to JSON Excel Add-in：Excel 内で Excel を JSON に変換し、Excel 環境とシームレスに連携します。
• Excel to JSON WPS Add-in：WPS 内で Excel を JSON に変換し、WPS 環境とシームレスに連携します。
• Excel to JSON API：HTTPS POST リクエストで Excel を JSON に変換します。
• Excel to JSON MCP Service：AI モデルの MCP SSE/StreamableHTTP リクエストで Excel を JSON に変換します。（<-- ここにいます。）

サーバー設定

利用可能な MCP サーバー：

Stdio（NPX）を使用

サーバー設定 JSON：

ケース 1：無料版（処理できるデータは最大 6 行）

無料版を使用する場合：

{
  "mcpServers": {
    "excel-to-json-mcp": {
      "args": [
        "excel-to-json-mcp"        
      ],
      "command": "npx"
    }
  }
}

ケース 2：Pro 版

Pro 版を使用する場合（有効な proCode が必要です）：

{
  "mcpServers": {
    "excel-to-json-mcp": {
      "args": [
        "excel-to-json-mcp"        
      ],
      "command": "npx",
      "env": {
        "proCode": "type in your proCode here"
      }
    }
  }
}

SSE を使用

v1.3.0 以降はサポートされていません

Streamable HTTP を使用

v1.3.0 以降はサポートされていません

MCP ツール

excel_to_json_mcp_from_data

タブ区切りの Excel データまたはカンマ区切りの CSV テキストデータを JSON 形式に変換します。

パラメーター

パラメーター	型	必須	説明
data	string	はい	2 行以上（ヘッダー行＋データ行）のタブ区切りまたはカンマ区切りのテキストデータ
options	object	いいえ	変換プロセスをカスタマイズするための任意の設定オブジェクト。

注： 入力データは、2 行以上（ヘッダー行＋データ行）のタブ区切り（Excel）またはカンマ区切り（CSV）のテキストである必要があります。

• 1 行目は「ヘッダー」行として扱われ、この MCP はこれを列名、ひいては JSON キーとして使用します。
• それ以降の行は「データ」行として扱われ、この MCP はこれらを JSON の値として扱います。

プロンプトの例 1：

次のデータを JSON 形式に変換してください。

Name	Age	IsStudent
John Doe	25	false
Jane Smith	30	true

プロンプトの例 2：

次のデータを JSON 形式に変換してください。

Name,Age,IsStudent
John Doe,25,false
Jane Smith,30,true

excel_to_json_mcp_from_url

指定された URL の Excel ファイルを JSON 形式に変換します。

パラメーター

パラメーター	型	必須	説明
url	string	はい	Excel（.xlsx）を指す URL
options	object	いいえ	変換プロセスをカスタマイズするための任意の設定オブジェクト。

注：

• Excel ファイルの各シートには、2 行以上（ヘッダー行＋データ行）が必要です。
  1. 1 行目は「ヘッダー」行として扱われ、この MCP はこれを列名、ひいては JSON キーとして使用します。
  2. それ以降の行は「データ」行として扱われ、この MCP はこれらを JSON の値として扱います。
• この Excel ファイルは「.xlsx」形式である必要があります。
• Excel ファイルの各シートは JSON オブジェクトに変換されます。
• 各 JSON オブジェクトには、「sheetName」（文字列）と「data」（オブジェクトの配列）プロパティが含まれます。
• 「data」配列内の各 JSON オブジェクトには、列名に対応するプロパティが含まれます。
• 「data」配列内の各 JSON オブジェクトには、セルの値に対応する値が含まれます。

プロンプト例 1

Excel ファイルを JSON に変換します。ファイル URL：https://tools.wtsolutions.cn/example.xlsx

プロンプト例 2

（URL がなく、オンライン AI LLM を使用している場合にのみ該当します）

.xlsx ファイルを 1 つアップロードしたばかりです。その URL を抽出し、Excel から JSON への変換のために MCP ツール 'excel_to_json_mcp_from_url' に送信してください。

オプションオブジェクト

Pro Code をお持ちでなくても、この MCP ツールを使用できます。ただし、処理されるデータは最大 6 行です。

省略可能な options オブジェクトには、変換処理をカスタマイズするための次のプロパティを指定できます。この機能を利用するには、有効な Pro Code が必要です（WTSolutions Subscription による Excel to JSON、JSON to Excel）。詳しくは料金をご覧ください。

プロパティ	型	デフォルト	説明
proCode	string	""	無制限のデータ処理に使用する Pro Code。有効な Excel to JSON サービスのサブスクリプションが必要です。
jsonMode	string	"flat"	JSON 出力の形式モード："nested" または "flat"
header	string	"row"	ヘッダーとして使用する行または列を指定します："row"（1 行目）または "column"（1 列目）
delimiter	string	"."	jsonMode が "nested" の場合に、ネストされた JSON キーに使用する区切り文字です。使用できる区切り文字は "."、"_"、"__"、"/" です。
emptyCell	string	"emptyString"	空のセルの処理方法："emptyString"、"null"、または "exclude"
booleanFormat	string	"trueFalse"	ブール値の形式："trueFalse"、"10"、または "string"
jsonFormat	string	"arrayOfObject"	JSON 出力全体の形式："arrayOfObject" または "2DArray"
singleObjectFormat	string	"array"	結果にオブジェクトが 1 つだけ含まれる場合の形式："array"（配列のままにする）または "object"（単一のオブジェクトとして返す）

注：

• delimiter は、jsonMode が "nested" の場合にのみ機能します。
• singleObjectFormat は、jsonFormat が "arrayOfObject" の場合にのみ機能します。
• jsonFormat の "2DArray" は、jsonMode が "flat" の場合にのみ機能します。

レスポンス形式

MCP ツールは、次の構造の JSON オブジェクトを返します。

フィールド	型	説明
isError	boolean	リクエストの処理中にエラーが発生したかどうかを示します
msg	string	'success' またはエラーの説明
data	string	変換されたデータです。URL を使用した場合はシートオブジェクトの配列、直接データを使用した場合は文字列、エラーが発生した場合は '' です。URL を使用した場合、各シートオブジェクトには 'sheetName'（string）と 'data'（オブジェクトの配列）が含まれます。

成功レスポンスの例

{
  "content": [{
    "type": "text",
    "text": "{\"isError\":false,\"msg\":\"success\",\"data\":\"[{\"Name\":\"John Doe\",\"Age\":25,\"IsStudent\":false},{\"Name\":\"Jane Smith\",\"Age\":30,\"IsStudent\":true}]\"}"
  }]
}

上記は MCP ツールからのレスポンスです。多くの場合、LLM はレスポンスを解釈して、以下の例のような JSON オブジェクトを提示します。

注：LLM モデルによって JSON オブジェクトの解釈方法が異なる場合があります。JSON オブジェクトが LLM モデルによって正しく解釈されているか確認してください。

{
  "isError": false,
  "msg": "success",
  "data": "[{\"Name\":\"John Doe\",\"Age\":25,\"IsStudent\":false},{\"Name\":\"Jane Smith\",\"Age\":30,\"IsStudent\":true}]"
}

{
  "isError": false,
  "msg": "success",
  "data": [
    {
      "Name": "John Doe",
      "Age": 25,
      "IsStudent": false
    },
    {
      "Name": "Jane Smith",
      "Age": 30,
      "IsStudent": true
    }
  ]
}

[
  {
    "Name": "John Doe",
    "Age": 25,
    "IsStudent": false
  },
  {
    "Name": "Jane Smith",
    "Age": 30,
    "IsStudent": true
  }
]

失敗した応答の例

{
  "content": [{
    "type": "text",
    "text": "{\"isError\": true, \"msg\": \"Network Error when fetching file\", \"data\": \"\"}"
  }]
}

上記は MCP ツールからの応答です。ほとんどの場合、LLM は応答を解釈して、以下の例のような JSON オブジェクトを提示します。

LLM モデルによって JSON オブジェクトの解釈方法が異なる場合があります。LLM モデルが応答を正しく解釈しているか確認してください。

{
  "isError": true,
  "msg": "Network Error when fetching file",
  "data": ""
}

または、「ファイルの取得中にネットワークエラーが発生しました。後でもう一度お試しください」と LLM が伝えることもあります。

データ型の処理

API はさまざまなデータ型を自動的に検出して変換します。

• 数値：数値に変換されます
• ブール値：true／false（大文字と小文字を区別しない）を認識し、ブール値に変換されます
• 日付：さまざまな日付形式を検出し、適切な形式に変換されます
• 文字列：文字列として扱われます
• 空の値：空の文字列として表されます

エラー処理

MCP は、一般的な問題について説明的なエラーメッセージを返します。

• Excel Data Format Invalid：入力データがタブ区切りまたはカンマ区切りではない場合
• At least 2 rows are required：入力データが 2 行未満の場合
• Both data and url received：data と url の両方のパラメーターが指定された場合
• Network Error when fetching file：指定された URL からファイルをダウンロードする際にエラーが発生した場合
• File not found：指定された URL にファイルが見つからない場合
• Blank/Null/Empty cells in the first row not allowed：ヘッダー行に空のセルが含まれている場合
• Server Internal Error：予期しないエラーが発生した場合
• Pro Code Invalid：指定された Pro Code が無効であるか、契約されていない場合
• Max 6 rows processed：有効な Pro Code が指定されていない場合、データの最初の 6 行のみが処理されます。

サービス利用規約とプライバシーポリシー

Excel to JSON MCP を使用すると、サービス利用規約およびプライバシーポリシーに同意したことになります。

料金

無料版では、処理できるデータは最大 6 行です。 Pro 版では、データを無制限に処理できます。

詳細については、料金ページをご覧ください。