xby-csv2json

DeepSeek Harness (DSH) 的插件：CSV转JSON转换器

一个基于FastMCP的CSV到JSON转换MCP服务器，提供高效的CSV数据转换服务。

功能

• set_xby_apikey — 在聊天中设置 API 密钥（自动持久化，重启有效）
• get_csv_info — 获取 CSV 文件的基本信息，用于辅助转换操作。

Args: file_path: CSV 文件路径，必须是有效的文件路径

Returns: 包含 CSV 文件信息的字典，结构为： { "success": bool, # 操作是否成功 "file_info": Dict[str, Any], # 文件详细信息 "message": str # 操作结果消息 }

文件信息包含以下字段：
- file_size: 文件大小（字节）
- row_count: 行数（估算值）
- column_count: 列数
- columns: 列名列表
- sample_data: 示例数据（前几行）
- file_encoding: 文件编码
- detected_delimiter: 检测到的分隔符

Raises: FileNotFoundError: 当文件路径不存在时 ValueError: 当文件格式错误或读取失败时 Exception: 其他未知错误

• convert_csv_file — 将 CSV 文件转换为 JSON 文件。

Args: file_path: CSV 文件路径，必须是有效的文件路径 output_file_path: 输出 JSON 文件路径（可选，默认为 CSV 文件同目录下同名 .json 文件） delimiter: CSV 分隔符，默认为逗号(,)，可以是制表符( )、分号(;)等 encoding: 文件编码，默认为 utf-8，支持 gbk、gb2312 等常见编码 skip_rows: 跳过的行数，默认为 0，用于跳过文件开头的注释或空行 header: 是否包含表头，默认为 True，如果为 False 则使用列索引作为键名 orient: JSON 输出格式，默认为 "records"，可选值： - "records": 每行作为一个字典对象的列表 - "values": 仅包含值的二维数组 - "split": 分开存储列名和数据的格式 indent: JSON 缩进，默认为 None（紧凑格式），可设置为 2 或 4 等值

Returns: 包含转换结果的字典，结构为： { "success": bool, # 转换是否成功 "json_file_path": str, # 生成的 JSON 文件路径 "message": str # 操作结果消息 }

Raises: FileNotFoundError: 当文件路径不存在时 ValueError: 当文件格式错误或转换失败时 Exception: 其他未知错误

• convert_csv_string — 将 CSV 格式的字符串转换为 JSON 格式。

Args: csv_content: CSV 格式的字符串内容，必须包含有效的 CSV 数据 delimiter: CSV 分隔符，默认为逗号(,)，可以是制表符( )、分号(;)等 skip_rows: 跳过的行数，默认为 0，用于跳过字符串开头的注释或空行 header: 是否包含表头，默认为 True，如果为 False 则使用列索引作为键名 orient: JSON 输出格式，默认为 "records"，可选值： - "records": 每行作为一个字典对象的列表 - "values": 仅包含值的二维数组 - "index": 包含索引的字典 - "table": 包含 schema 和数据的完整表格格式 - "split": 分开存储列名和数据的格式 indent: JSON 缩进，默认为 None（紧凑格式），可设置为 2 或 4 等值

Returns: 包含转换结果的字典，结构为： { "success": bool, # 转换是否成功 "json": Any, # 转换后的 JSON 数据 "message": str # 操作结果消息 }

Raises: ValueError: 当字符串格式错误或转换失败时 Exception: 其他未知错误

安装

方式一：从 GitHub 直接安装（推荐）

# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-csv2json

方式二：从本地目录安装（开发模式）

# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-csv2json

方式三：通过 cordis.patch.yml 开发调试

dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml

配置

获取 API 密钥

前往 小笨羊官网 注册并获取 API 密钥。