peekmcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@peekmcpShow me the schema and a sample from sales.csv"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
peekmcp
Zero-dependency MCP server and CLI that lets AI agents inspect local CSV/JSON/JSONL files without dumping entire files into context.
đ¯ 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:
Fork the repo
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
đ License
MIT Š 2026 â See LICENSE for details.
If this project helped you, please â star it!
This server cannot be deployed
Maintenance
Related MCP Connectors
Query, join, profile, clean and convert CSV/JSON/Parquet with server-side DuckDB over MCP.
Nifty's MCP server â exposes tasks, projects, messages, and files as tools for AI agents.
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Related MCP Servers
- AlicenseAqualityAmaintenanceA token-efficient, schema-aware MCP server that enables AI assistants to safely read, modify, query, and validate JSON, YAML, and TOML files with automatic schema detection and format conversion capabilities.823 PyPI9MIT
- AlicenseNot gradedqualityDmaintenanceAn 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.119 npmMIT
- AlicenseAqualityAmaintenanceMCP 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.11MIT
- FlicenseAqualityAmaintenanceMCP 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.39149 PyPI81-