Sample Data MCP
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., "@Sample Data MCP generate 10 test records with customer ID, name, status, and signup date"
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.
Sample Data MCP
A Model Context Protocol (MCP) server that generates fixed-length test data based on field specifications. This tool helps developers create realistic test datasets with customizable field types and formats.
Features
Generate fixed-length test data records
Support for multiple field types:
string: Random names using Faker libraryenum: Random selection from provided valuesinteger: Random integers within specified rangedate: Random dates with customizable formatfiller: Space padding fields
Configurable field length and constraints
MCP-compatible for integration with Claude Code
Related MCP server: mockhero
Installation
Prerequisites
Python 3.13 or higher
Install with UV
Clone or download this project
Navigate to the project directory
Install dependencies:
uv sync
Install into Claude Code
Add the MCP server to your Claude Code configuration. Edit your MCP settings file (typically
~/.config/claude-code/mcp_servers.jsonor similar):{ "mcpServers": { "sample-data-mcp": { "command": "uv", "args": ["run", "/path/to/sample-data-mcp/main.py"], "cwd": "/path/to/sample-data-mcp" } } }Restart Claude Code to load the new MCP server
Usage
Once installed, you can use the generate_test_data_tool through Claude Code to create test data:
Example Field Specification
fields = [
{
"name": "customer_id",
"type": "integer",
"length": 8,
"min": 1000,
"max": 9999
},
{
"name": "customer_name",
"type": "string",
"length": 25
},
{
"name": "status",
"type": "enum",
"length": 6,
"values": ["ACTIVE", "INACTIVE", "PENDING"]
},
{
"name": "signup_date",
"type": "date",
"length": 8,
"format": "%Y%m%d"
},
{
"name": "filler",
"type": "filler",
"length": 5
}
]Field Types
Type | Description | Required Fields | Optional Fields |
| Random names |
| - |
| Random selection from list |
| - |
| Random integer |
|
|
| Random date |
|
|
| Space padding |
| - |
Development
Testing Locally
uv run mcp dev main.pyDependencies
faker: For generating realistic fake datamcp: Model Context Protocol implementationpydantic: Data validation and settings management
License
This project is provided as-is for educational and development purposes.
Available Tools
1 toolgenerate_test_data_toolC
Generate fixed-length test data based on a field specification
Inputs: fields (required), num_records (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly distinct as it is the sole tool available.
Since there is only one tool, naming consistency is inherently perfect. The tool name 'generate_test_data_tool' follows a clear verb_noun pattern, but consistency cannot be assessed across multiple tools.
A single tool is generally too few for a server's purpose, as it limits functionality and suggests an incomplete or overly narrow scope. For a data generation server, one tool is insufficient to cover typical needs like varied data types or configurations.
The server's domain appears to be test data generation, but with only one tool, the surface is severely incomplete. It lacks operations for different data formats, validation, customization, or management, which are essential for comprehensive data handling.
Maintenance
Related MCP Connectors
Generate realistic relational test data — 156 field types, 22 locales, JSON/CSV/SQL, free previews.
Format-true synthetic test data for 90 countries — IBANs, SWIFT/BIC, IDs, cards, all certified.
Generate realistic, FK-consistent synthetic test data for your databases from your AI assistant.
Massa de teste brasileira válida: CPF, CNPJ, cartão, conta e mais, em CSV, JSON, SQL ou Excel.
Related MCP Servers
- AlicenseBqualityDmaintenanceGenerates realistic mock data using Faker.js for database seeding, API testing, and development environments. Supports person/company data, custom patterns, multi-locale generation, and structured datasets with referential integrity.462 npm7MIT
- AlicenseAqualityDmaintenanceGenerate realistic relational test data with 156 field types, 22 locales, and foreign key integrity. One API call seeds your entire database.51MIT
- FlicenseNot gradedqualityDmaintenanceGenerates realistic, context-aware synthetic data for AI agents to populate databases, mock APIs, and create test scenarios without exposing real PII.7 npm3-
- AlicenseAqualityDmaintenanceGenerates realistic, referentially-coherent test data (SQL INSERTs, JSON, or CSV) from your database schema, resolving foreign keys and respecting constraints. Paste CREATE TABLE DDL or a JSON schema and get ready-to-run seed data with valid relationships.2MIT