peekmcp
Click on "Install 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 installed
Maintenance
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
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.89MIT
- FlicenseNot 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.-
- 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.3981-