Json To Excel By Wtsolutions

WTSolutions の JSON to Excel MCP

中文

はじめに

JSON to Excel MCP（Model Context Protocol）は、Model Context Protocol を使用して JSON データを CSV 形式の文字列に変換するための標準化されたインターフェースを提供します。この MCP 実装には、データ変換用の次の 2 つのツールがあります。

• json_to_excel_mcp_from_data：JSON データ文字列を CSV 形式に変換します。
• json_to_excel_mcp_from_url：指定された URL（.json 形式）の JSON ファイルを CSV 形式の文字列に変換します。

JSON to Excel MCP は、WTSolutions の JSON to Excel ツールキットの一部です。

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

サーバー設定

利用可能な MCP サーバー（SSE および Streamable HTTP）：

Stdio（NPX）の使用

サーバー設定 JSON：

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

無料版を使用する場合：

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

ケース 2：Pro 版

有効な proCode を使用して Pro 版を利用する場合：

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

SSE の使用

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

Streamable HTTP の使用

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

MCP ツール

json_to_excel_mcp_from_data

JSON データ文字列を CSV 形式の文字列に変換します。

パラメーター

パラメーター	型	必須	説明
data	string	はい	CSV に変換する JSON データ文字列。有効な JSON 配列またはオブジェクトである必要があります。
options	object	いいえ	変換処理をカスタマイズするための任意の設定オブジェクトです。

注：

• 入力データは有効な JSON 文字列である必要があります。JSON スキーマはJSON Schemaで確認でき、バリデーターはJSON to Excel Web Appで利用できます。
• JSON がオブジェクトの配列の場合、各オブジェクトは CSV の行として扱われます。
• JSON が単一のオブジェクトの場合、キーと値のペアを含む CSV に変換されます。
• CSV には、JSON オブジェクトのキーに基づくヘッダーが含まれます。
• このツールは、簡単に Excel に変換またはインポートできる CSV 形式のデータを返します。

Options オブジェクト

options オブジェクトには、次のプロパティを指定できます。

プロパティ	型	デフォルト	説明
proCode	string	""	JSON to Excel サービスの Pro Code です。
jsonMode	string	"flat"	JSON 出力の形式モード："nested" または "flat"。
delimiter	string	"."	jsonMode が "nested" の場合にネストされた JSON キーに使用する区切り文字です。使用できる区切り文字は ".", "_", "__", "/" です。
maxDepth	string	"unlimited"	jsonMode が "nested" の場合の、ネストされた JSON オブジェクトの最大深度です。maxDepth には "unlimited" または "1" ～ "20" を指定できます。

注：

• 有効なPro Codeがない場合、処理される行数は最大 6 行です。
• 詳細な変換ルールはFeaturesで確認できます。

プロンプト例 1：

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

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

プロンプトの例 2：

次の JSON オブジェクトを CSV 形式に変換してください。

{
  "Name": "John Doe",
  "Age": 25,
  "IsStudent": false,
  "Courses": ["Math", "Science"]
}

json_to_excel_mcp_from_url

指定した URL の JSON データを Excel データに変換します。

パラメーター

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

注：

• url は一般にアクセス可能である必要があります。
• JSON ファイルは .json 形式である必要があります。
• JSON ファイルには有効な JSON 配列またはオブジェクトが含まれている必要があります。JSON スキーマは JSON Schema で確認でき、バリデーターは JSON to Excel Web App で利用できます。
• JSON がオブジェクトの配列の場合、各オブジェクトは CSV の行として扱われます。
• JSON が単一のオブジェクトの場合、キーと値のペアを含む CSV に変換されます。
• このツールは、Excel に簡単に変換またはインポートできる CSV 形式のデータを返します。

Options オブジェクト

options オブジェクトには、次のプロパティを含めることができます。

プロパティ	型	デフォルト	説明
proCode	string	""	JSON to Excel サービスの Pro Code。
jsonMode	string	"flat"	JSON 出力の形式モード：「nested」または「flat」
delimiter	string	"."	jsonMode が「nested」の場合に、ネストされた JSON キーに使用する区切り文字。「.」、「_」、「__」、「/」を使用できます。
maxDepth	string	"unlimited"	jsonMode が「nested」の場合の、ネストされた JSON オブジェクトの最大深度。maxDepth には「unlimited」または「1」～「20」を指定できます。

注：

• 有効な Pro Code がない場合、最大 6 行が処理されます。
• 詳細な変換ルールは Pro Features で確認できます。

プロンプトの例 1

JSON ファイルを Excel に変換してください。ファイル URL：https://mcp.wtsolutions.cn/example.json

プロンプトの例 2

（URL がなく、オンライン AI LLM を使用する場合のみ適用）

.json ファイルを 1 つアップロードしました。URL を抽出して、JSON から Excel への変換のために MCP ツール「json_to_excel_mcp_from_url」に送信してください。

応答形式

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

フィールド	型	説明
isError	boolean	リクエストの処理中にエラーが発生したかどうかを示します
msg	string	「success」またはエラーの説明
data	string	変換された CSV データ文字列。エラーが発生した場合は '' です。この CSV データは Excel に簡単にインポートできます。

成功応答の例

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

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

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

{
  "isError": false,
  "msg": "success",
  "data": "Name,Age,IsStudent\nJohn Doe,25,false\nJane Smith,30,true"
}

失敗した応答の例

{
  "content": [{
    "type": "text",
    "text": "{\"isError\": true, \"msg\": \"Invalid JSON format\", \"data\": \"\"}"
  }]
}

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

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

{
  "isError": true,
  "msg": "Invalid JSON format",
  "data": ""
}

または、「Invalid JSON format, please provide a valid JSON string」と表示される場合もあります。

データ型の処理

API は JSON 内のさまざまなデータ型を自動的に処理します。

• 数値：CSV 内で数値に変換されます
• ブール値：'true'／'false' 文字列に変換されます
• 文字列：必要に応じてエスケープされ、引用符で囲まれます
• 配列：JSON.stringify の配列文字列に変換されます
• オブジェクト：JSON.stringify のオブジェクト文字列に変換されます

エラー処理

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

• Invalid JSON format：入力データが有効な JSON 文字列ではない場合
• Empty JSON data：入力データが空の JSON 文字列の場合
• Network Error when fetching file：指定された URL からのファイルのダウンロード中にエラーが発生した場合
• File not found：指定された URL のファイルが見つからない場合
• Server Internal Error：予期しないエラーが発生した場合
• Pro Code Invalid：指定された Pro Code が無効であるか、サブスクリプションに登録されていない場合
• Max 6 rows processed：有効な Pro Code が指定されていない場合、データの先頭 6 行のみが処理されます

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

JSON to Excel MCP を使用すると、サービス利用規約とプライバシーポリシーに同意したものとみなされます。

料金

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

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