Skip to main content
Glama

peekmcp

Zero-dependency MCP server and CLI that lets AI agents inspect local CSV/JSON/JSONL files without dumping entire files into context.

License Language Status PyPI Python MCP License


đŸŽ¯ Why?

Trending repos show heavy investment in MCP, agent context pipelines, and token-efficient tooling, but most file MCP servers expose raw bytes or require databases. Developers frequently have quick CSV/JSON/JSONL artifacts that agents need to inspect without loading entire files into context. PeekMCP fills that gap with a zero-dependency stdio MCP server and CLI that provides schema, samples, and paginated filtered queries.

Target audience: AI agent developers, data engineers, and local LLM users who need safe, token-efficient access to flat files during coding, analysis, and automation.

Related MCP server: MCP Data Catalog

✨ Features

  • ✨ Zero-dependency MCP stdio server with list_files, inspect_file, and query_table tools

  • ✨ CLI for listing, inspecting, and querying CSV/TSV/JSON/JSONL files

  • ✨ Token-saving pagination, column selection, substring filtering, and truncated cells

🚀 Quick Start

# Install
pip install peekmcp

# Run
peekmcp --help

đŸ“Ļ Installation

From Source

git clone https://github.com/YOUR_USERNAME/peekmcp.git
cd peekmcp
# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest -v

đŸŽŦ Demo

The GIF above was recorded using Charm VHS:

vhs < demo.tape

📖 Usage

# Show help
peekmcp --help

# Common usage examples
peekmcp --example

đŸ—ī¸ Architecture

graph LR
    A[Input] --> B[Core Engine]
    B --> C[Output]
    B --> D[Plugins]
    D --> E[Extensions]

🤝 Contributing

Contributions are welcome! Please:

  1. Fork the repo

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

📄 License

MIT © 2026 — See LICENSE for details.


If this project helped you, please ⭐ star it!

Made with â¤ī¸ and AI

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides AI assistants with structured, type-safe access to tabular datasets from CSV files. It enables users to list, describe, and query data using filters and projections with support for hot reloading.
    -
  • A
    license
    A
    quality
    A
    maintenance
    MCP server that profiles local data files (CSV, Parquet, JSON, Excel) and returns compact structured summaries with data-quality flags, enabling AI agents to understand datasets without seeing raw rows.
    1
    1
    MIT
  • F
    license
    A
    quality
    A
    maintenance
    MCP server for tabular data retrieval that indexes local CSV, Excel, Parquet, and JSONL files once and answers questions via column profiles, filtered rows, server-side aggregations, and joins, drastically reducing token usage for large datasets.
    39
    81
    -