MK

maxgab/kaelix-data-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

0 stars 0 forks 质量 80 趋势 14MIT

免费无依赖本地MCP服务器:CSV/JSON质量审计和SHA-256。25个测试;由KAELIX Studio制作。

概览

A 用于确定性 CSV/JSON 质量检查和 SHA-256。在 Claude Desktop、Cursor 或任何 MCP 标准客户端中运行 Python 3.10+。这是一个 ,不是付费 API 或投资产品。 由定制的 Python/API 自动化、CSV验证和代码质量保证服务构建。 CSV/JSON 工具返回的是 ,而不是原始的行/字段值。没有钱包密钥、账户认证、凭证、文件访问、追踪、外部 HTTP 调用、shell 命令或网络监听器。MCP 客户端本身可以记录请求;在有疑问时使用合成示例。 1. 下载此仓库(git clone https://github.com/MaxGab/kaelix-data-mcp.git). 2.确认 Python >= 3.10: python3 --version。3. 将你的 MCP 客户端指向已下载的脚本。 示例 Claude 桌面 / 光标 MCP 配置(用本地路径替换绝对路径): 不需要 pip 安装或 API 令牌。这是一个服务器,不是公共 HTTP 端点。进程只打印 JSON-RPC 的 stdout 响应。

概述(AI 翻译)

一个可用的本地专用MCP服务器,用于确定性CSV/JSON质量检查和SHA-256。在Claude Desktop、Cursor或任何MCP stdio客户端中运行Python 3.10+。这是一个免费的开发者工具,不是付费API或投资产品。

由KAELIX Studio构建——定制Python/API自动化、CSV验证和代码质量保证服务。

它的作用

MCP工具 输入 返回
kaelix_audit_csv CSV文本,可选必填列 行/列计数、重复行、空格、空白、宽度错误
kaelix_audit_json JSON 文本,可选必修键 JSON 结构,顶层计数,缺失键,语法问题
kaelix_sha256 UTF-8文本 SHA-256摘要

CSV/JSON 工具只返回 聚合信息,而非原始行/字段值。无钱包密钥、账户认证、凭证、文件访问、追踪、外部 HTTP 调用、shell 命令或网络监听器。MCP 客户端本身可以记录请求;有疑问时使用合成示例。

安装只需三步

  1. 下载此仓库(git clone https://github.com/MaxGab/kaelix-data-mcp.git)。
  2. 确认 Python >= 3.10: python3 --version。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

KAELIX Local Data MCP — zero-dependency AI tools

A working, local-only MCP server for deterministic CSV/JSON quality checks and SHA-256. Run it with Python 3.10+ in Claude Desktop, Cursor, or any MCP stdio client. This is a free developer utility, not a paid API or investment product.

Built by KAELIX Studio — custom Python/API automation, CSV validation and code QA services.

What it does

MCP tool Input Returns
kaelix_audit_csv CSV text, optional required columns Row/column counts, duplicate rows, empty cells, whitespace, width errors
kaelix_audit_json JSON text, optional required keys JSON structure, top-level counts, missing keys, syntax issues
kaelix_sha256 UTF-8 text SHA-256 digest

CSV/JSON tools return aggregated information only, not raw row/field values. No wallet keys, account authentication, credentials, file access, tracking, external HTTP calls, shell commands, or network listeners. The MCP client itself may log requests; use synthetic examples when in doubt.

Install in 3 steps

  1. Download this repository (git clone https://github.com/MaxGab/kaelix-data-mcp.git).
  2. Confirm Python >= 3.10: python3 --version.
  3. Point your MCP client at the downloaded script.

Example Claude Desktop / Cursor MCP configuration (replace the absolute path with your local path):

{
  "mcpServers": {
    "kaelix-local-data": {
      "command": "python3",
      "args": ["/absolute/path/to/kaelix-data-mcp/kaelix_mcp.py"]
    }
  }
}

No pip install or API tokens necessary. This is an stdio server, not a public HTTP endpoint. The process prints only JSON-RPC responses to stdout.

Test without an MCP client

python3 -m unittest -v test_kaelix_mcp.py
python3 kaelix_mcp.py

Then enter one complete JSON line:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"demo","version":"1.0"}}}

On another line, request tools/list or tools/call. The included unit tests run a real subprocess and exercise the full stdio handshake and tool invocation.

MCP CSV example

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"kaelix_audit_csv","arguments":{"csv_text":"id,total\n1, 20\n1,20\n2,\n","required_columns":["id","total"]}}}

The response contains only quality metrics, not any data rows.

Boundaries and transparency

The server caps inbound requests at 128 KB, tool text at 64 KB, and CSV processing at 4,000 rows × 200 columns. It never opens arbitrary paths. Duplicate-row detection uses transient SHA-256 fingerprints, and nothing is stored between calls.

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "kaelix-local-data": { "command": "python3", "args": ["/absolute/path/to/kaelix-data-mcp/kaelix_mcp.py"] } } }