zsv MCP

MCP开发工具

提供方 budgiedownunder

开发工具 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursorVS Code

一个基于Go语言的MCP服务器,为zsv命令行工具提供运行和帮助功能。

一句话选型结论

按资料字段整理

zsv MCP 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

命令行工具Go本地部署Go语言MCP协议开发工具CSV处理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
zsv MCP当前 2 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方budgiedownunder上游标注的维护方 budgiedownunder
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.7 KB
来自项目仓库与上游目录的原文,未做删改

zsv mcp

一个基于Go的模型上下文协议(MCP)服务器,为 zsv CLI(请参阅:https://github.com/liquidaty/zsv).

本项目使用官方MCP Go SDK: github.com/modelcontextprotocol/go-sdk.

特性

  • zsv_run:run zsv 使用显式参数数组和返回捕获的stdout。
  • zsv_help:run zsv --help 并返回捕获的stdout。
  • 通过环境变量配置运行时值。
  • 核心工具行为的单元测试。

仓库的规划```

.
|- .cursor/
| |- mcp.json # Cursor MCP config
|- .github/
| |- copilot-instructions.md
|- .mcp.json # Claude Code MCP config
|- .vscode/
| |- mcp.json # VS Code / GitHub Copilot MCP config
| |- settings.json # VS Code MCP config (legacy format)
|- CLAUDE.md # Cursor/Claude AI instructions for using zsv MCP tools
|- config/
| |- config.go # Environment-based configuration
|- docs/
| |- TOOL_REFERENCE.md # detailed tool contracts and examples
|- main.go # MCP server entry point
|- main_test.go # Core handler tests
|- prompts/
| |- tool_usage.go # tool usage guidance prompt
|- resources/
| |- tool_usage.go # tool usage guidance resource
|- sample_data/
| |- data.csv # sample CSV for example prompts
|- SETUP.md # VS Code local setup notes
|- tools/
| |- help.go # zsv_help tool
| |- run.go # zsv_run tool
| |- run_help_test.go # zsv_run/zsv_help tool tests


## 需求

- 转到1.23+
- `zsv` CLI可在您的 `PATH` 为了 `zsv_run` 和 `zsv_help` 工具,或 `ZSV_PATH` 设置为二进制位置-请参阅 安装 细节。

## 快速开始

1. 克隆并进入项目目录。

1. 安装依赖项:```bash
go mod download
  1. 构建:```bash

Linux/macOS

go build -o zsv-mcp

Windows

go build -o zsv-mcp.exe


4. 启动服务器:```bash
# Linux/macOS
./zsv-mcp

# Windows
zsv-mcp.exe

服务器通过stdio进行通信。看 MCP客户端配置文件 将其连接到您的编辑器。

  1. 运行测试:```bash
    go test ./...

## 配置

环境变量被读入 `config/config.go`.

- `SERVER_NAME` (默认值: `zsv-mcp`)
- `VERSION` (默认值: `v1.0.0`)
- `LOG_LEVEL` (默认值: `info`)
- `ZSV_PATH` (默认值: `zsv`)被使用 `zsv_run` 和 `zsv_help`

日志记录注意事项:

- 服务器将日志写入 `stderr` 仅为了避免干扰上的MCP stdio协议流量 `stdout`.
- 支持 `LOG_LEVEL` 值: `debug`, `info`, `warn` (或 `warning`), `error`.
- 未知 `LOG_LEVEL` 值回落到 `info` 并在启动时发出警告。

PowerShell示例:```powershell
$env:SERVER_NAME = "zsv-mcp"
$env:VERSION = "v1.0.0"
$env:LOG_LEVEL = "debug"
$env:ZSV_PATH = "zsv"
zsv-mcp.exe

MCP客户端配置文件

该存储库附带了预配置的文件,因此MCP兼容的客户端可以在不进行手动设置的情况下发现并启动服务器。所有配置都期望二进制文件被命名 zsv-mcp (没有 .exe 扩展)——请参阅上面快速入门中的跨平台说明。

.mcp.json

Claude Code读取的项目级MCP发现文件。它注册 zsv-mcp 作为 stdio 服务器,没有额外的参数或环境覆盖。这 command 路径是相对于项目根目录的,因此必须从该目录启动客户端(或相应地调整路径)。```json
{
"mcpServers": {
"zsv-mcp": {
"type": "stdio",
"command": "./zsv-mcp",
"args": [],
"env": {
"ZSV_PATH": "zsv",
"LOG_LEVEL": "debug"
}
}
}
}


### `.vscode/mcp.json`

在较新的VS Code版本中引入了特定于VS Code的MCP服务器配置。VS Code读取此文件以填充聊天MCP工具列表。使用 `${workspaceFolder}` 因此,无论在何处打开VS Code,路径都能正确解析。VS Code中的GitHub Copilot也使用此文件。```json
{
"servers": {
"zsv-mcp": {
"command": "${workspaceFolder}/zsv-mcp",
"type": "stdio",
"args": [],
"env": {
"ZSV_PATH": "zsv",
"LOG_LEVEL": "debug"
}
}
}

.vscode/settings.json

在下注册服务器的工作区设置文件 mcpServers 钥匙。VS Code的MCP集成的早期版本使用此文件,而不是 .vscode/mcp.jsonThe disabled 字段控制服务器是否处于活动状态,以及 alwaysAllow 列出在没有用户提示的情况下自动批准的任何工具调用。```json
{
"mcpServers": {
"zsv-mcp": {
"command": "${workspaceFolder}/zsv-mcp",
"args": [],
"disabled": false,
"alwaysAllow": [],
"env": {
"ZSV_PATH": "zsv",
"LOG_LEVEL": "debug"
}
}
}
}


两者 `.vscode/mcp.json` 和 `.vscode/settings.json` 指向相同的二进制文件;VS Code查询的文件取决于其版本,因此两者都包含在内以保持兼容性。

### `.cursor/mcp.json`

光标MCP配置。Cursor支持 `${workspaceFolder}` 不同版本之间不一致,因此此配置仅按名称引用二进制文件。确保 `zsv-mcp` 在你的 `PATH` (例如,通过 `go install`)或者用二进制文件的绝对路径替换命令值。```json
{
"mcpServers": {
"zsv-mcp": {
"command": "zsv-mcp",
"args": [],
"env": {
"ZSV_PATH": "zsv",
"LOG_LEVEL": "debug"
}
}
}
}

克劳德桌面版

Claude Desktop使用用户级配置文件,而不是仓库级配置文件。将以下内容添加到您的 claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: `%APPDATA%\Claude\claude_desktop_config.json`json { "mcpServers": { "zsv-mcp": { "command": "/absolute/path/to/zsv-mcp", "args": [], "env": { "ZSV_PATH": "zsv", "LOG_LEVEL": "debug" } } } }

工具摘要

看 工具参考.md 获取完整的请求和响应详细信息。

  • zsv_run(cmd[])
  • zsv_help()

示例提示

以下提示可用于任何兼容MCP的AI客户端(Claude、Cursor、VS Code Copilot等)来练习zsv MCP工具。大多数提示都明确指定要使用的MCP工具,这样AI就不会扫描项目源文件以获取上下文。最后一个没有明确命名工具,而是依赖于AI客户端从MCP服务器和为其提供的指导中推断出来。

出于验证目的,应为每个客户端使用新的提示,以确保AI客户端不受先前提示消息结果的影响。在处理过程中,您可能会看到AI客户端在学习如何向MCP服务器发出格式良好的请求时进行自我纠正。

验证安装

> 使用zsv_help MCP工具,向我显示zsv帮助文本。

AI呼叫 zsv_help() 并返回zsv CLI的顶级帮助输出,列出可用的子命令。如果失败,则zsv MCP工具未注册, zsv 未打开 PATH 或 ZSV_PATH 设置不正确。

从文件中选择列

> 使用zsv_run MCP工具,只显示sample_data/data.csv中的名称和国家列。

AI呼叫 zsv_run 随着 select 子命令提取两列并返回一个过滤后的CSV。

计算列的平均值

> 使用zsv_run MCP工具,计算sample_data/data.csv中人员的平均年龄。

AI呼叫 zsv_run 使用 sql 带有查询的子命令,例如 select avg(cast([Age] as real)) from data,然后报告结果。

多阶段操作

> 使用zsv_run MCP工具,仅从sample_data/data.csv中选择“名称”和“年龄”列,然后按年龄降序对结果进行排序。

人工智能将决定如何处理这个问题。它可能决定发布两个 zsv_run 电话(select 缩小列,然后 sql 排序)或将这两个操作组合成一个 sql 查询。然后,它将报告最终结果。

多级操作(未指定特定的MCP工具)

> 使用zsv,从sample_data/data.csv中仅选择“名称”和“国家”列,然后按“名称”升序对结果进行排序。

人工智能将决定如何处理这个问题,可能会参考zsv MCP使用指南,并最终执行 sql 通过电话 zsv_run 生成并显示最终结果。

发展

  • 本地编辑器设置: 设置.md
  • 贡献工作流程: 贡献.md

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
zsv MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

zsv MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

zsv MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

zsv MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

zsv MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

zsv MCP 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 命令行工具、开发工具、Go、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。