mcpField
C
csvto-mcp

csvto-mcp

本地服务
csvtosite.com生产力09 周前更新
代码仓库访问官网

关于 csvto-mcp

csvto-mcp 是面向通过 AI 助手处理结构化数据的本地文件转换 MCP 服务，支持 CSV、JSON 和 Excel。转换后的文件写在源文件旁，不会上传，也不会让文件内容经过模型上下文。

主要功能

  1. 01转换 CSV、JSON 和 Excel 文件
  2. 02在本地处理文件
  3. 03将结果写在源文件旁
  4. 04按整列推断数据类型
  5. 05保留转换可能改变的数值

适用场景

  1. 01将本地 CSV 文件转换为 Excel
  2. 02转换 JSON 数据以供电子表格使用
  3. 03转换时保留前导零和数值精度

MCP 相关

csvto-mcp 向 MCP 客户端提供本地文件转换工具。客户端传入文件路径后，服务在本地写入转换结果，不上传文件，也不将内容传入模型上下文。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "bishop81-csvto": {
      "command": "npx",
      "args": [
        "-y",
        "csvto-mcp"
      ]
    }
  }
}
启动命令npx -y csvto-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmcsvto-mcp0.1.2

工具

10

收录的工具列表 · 更新于 2 周前

参数类型必填说明
formatenum否默认根据文件扩展名检测。csv | json | xlsx
has_headerboolean否将第一行视为列名。默认值为 true。
input_pathstring是此计算机上源文件的绝对路径。

详细介绍

csvto

在数据所在的位置进行 CSV、JSON 和 Excel 转换。

  • csvto-mcp — 一个 MCP 服务。向 AI 助手提供文件路径；它会在本地转换，并将结果写在文件旁边。不会上传任何内容，文件内容也不会经过模型的上下文。
  • @csvto/core — 转换引擎。没有 DOM、fs 或网络依赖，因此同一套经过测试的代码可在浏览器、本地 MCP 进程或服务端运行。

浏览器工具 csvtosite.com 也使用同一引擎进行转换，整个过程在客户端完成，文件同样不会上传。

安装 MCP 服务

claude mcp add csvto -- npx -y csvto-mcp

或者在任意 MCP 客户端的配置中：

{
  "mcpServers": {
    "csvto": { "command": "npx", "args": ["-y", "csvto-mcp"] }
  }
}

需要 Node 18+。完整的工具列表和行为说明：packages/mcp/README.md。

按列推断类型，而不是按单元格

这一点至关重要，也是大多数转换器会悄悄损坏数据的地方。只有当一列中的每个值都能在往返转换后保持完全一致时，才会将其转换为数字。如果某个值会发生变化，整列都会保留为文本：

  • 01234 会保留前导零，而不会变成 1234
  • 16 位账号会保持原样，而不会变成 1.23457E+14
  • 1250.50 会保留末尾的零，而不会变成 1250.5
  • 一列中不会混杂数字和字符串

已在测试中验证：01234 经过 CSV → xlsx → CSV 往返转换后保持不变。

开发

npm install
npm test          # 49 tests
npm run build

packages/core 必须保持环境无关——不能使用 window、fs 或 fetch。正是这一限制，让同一套经过测试的引擎能够服务于各种场景。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。