matrix-pattern
Advanced tools
Matrix Pattern System MCP Server - Advanced pattern management and synchronization
Advanced pattern management and synchronization MCP server for Claude applications. The Matrix Pattern System provides a structured approach to organizing and coordinating complex development patterns across multiple dimensions.
Clone and setup:
git clone <repository-url>
cd matrix-mcp-server
./setup.sh
Install dependencies:
npm install
Start the server:
npm start
Add to Claude configuration:
# Copy the provided configuration
cp claude_mcp_config.json ~/.claude/mcp_servers.json
The Matrix Pattern System organizes development patterns in a two-dimensional structure:
matrix_create_cell - Create Pattern CellsCreate new cells in the matrix pattern system.
// Example: Create authentication requirements cell
{
"cellId": {
"row": "requirements",
"column": "authentication"
},
"data": {
"content": "# Authentication Requirements\n\n## Functional Requirements\n- User login with email/password\n- Multi-factor authentication support\n- Session management\n\n## Non-Functional Requirements\n- Security: OAuth 2.0 compliance\n- Performance: < 2s login time\n- Availability: 99.9% uptime",
"metadata": {
"priority": "high",
"horizontal_type": "requirements"
}
}
}
matrix_read_cell - Read Pattern CellsRetrieve cell content and metadata.
// Example: Read specific cell
{
"cellId": {
"row": "architecture",
"column": "authentication"
}
}
matrix_sync_horizontal - Horizontal Pattern SyncSynchronize patterns across feature domains within the same development phase.
// Example: Sync requirements from authentication to authorization
{
"sourceRow": "requirements",
"targetRow": "requirements",
"columns": ["authentication", "authorization"]
}
matrix_sync_vertical - Vertical Pattern SyncCascade patterns from one development phase to another.
// Example: Sync authentication from requirements to architecture
{
"column": "authentication",
"fromRow": "requirements",
"toRow": "architecture"
}
matrix_list_verticals - List Column CellsShow all cells in a vertical column (feature domain).
// Example: List all authentication-related cells
{
"column": "authentication"
}
matrix_list_horizontals - List Row CellsShow all cells in a horizontal row (development phase).
// Example: List all requirement cells
{
"row": "requirements"
}
matrix_read_horizontal_instructions - Get Sync InstructionsRetrieve synchronization instructions and metadata for horizontal patterns.
// Example: Get requirements sync instructions
{
"row": "requirements"
}
matrix-mcp-server/
├── src/ # Source code
│ ├── index.js # Main MCP server
│ ├── validator.js # Cell content validator
│ ├── matrix-fs.js # File system utilities
│ ├── sync-engine.js # Synchronization engine
│ └── test/ # Test files
├── .matrix_pattern/ # Matrix Pattern system files
│ ├── matrix/ # Pattern storage (*.json files)
│ ├── metadata/ # Pattern metadata
│ │ ├── horizontals/ # Horizontal pattern metadata
│ │ └── sync-reports/ # Synchronization reports
│ │ ├── horizontal/ # Horizontal sync reports
│ │ └── vertical/ # Vertical sync reports
│ └── config.json # System configuration
├── claude_mcp_config.json # Claude MCP configuration
├── package.json # Project configuration
├── setup.sh # Setup script
└── README.md # This file
The claude_mcp_config.json file contains the complete MCP server configuration for Claude integration.
The Matrix Pattern system is configured via .matrix_pattern/config.json:
{
"matrix_pattern": {
"version": "1.0.0",
"initialized": true,
"config": {
"max_patterns": 1000,
"auto_cleanup": true,
"sync": {
"horizontal": {
"conflict_resolution": "manual"
},
"vertical": {
"auto_cascade": false
}
}
}
}
}
// 1. Create requirements cell
matrix_create_cell({
cellId: { row: "requirements", column: "user-management" },
data: {
content: "# User Management Requirements\n- User registration\n- Profile management\n- Account deactivation",
metadata: { horizontal_type: "requirements" }
}
})
// 2. Sync to architecture phase
matrix_sync_vertical({
column: "user-management",
fromRow: "requirements",
toRow: "architecture"
})
// 3. List all user-management cells
matrix_list_verticals({
column: "user-management"
})
// 4. Sync architecture across related features
matrix_sync_horizontal({
sourceRow: "architecture",
targetRow: "architecture",
columns: ["user-management", "authentication"]
})
import { CellValidator } from './src/validator.js';
const validator = new CellValidator();
const result = validator.validateCell(cellData, {
horizontal_type: 'requirements'
});
console.log(validator.getValidationSummary(result));
npm start - Start the MCP servernpm run dev - Start with file watchingnpm test - Run comprehensive test suitenpm run build - Build and validate projectnpm run setup - Run setup scriptnpm run init-matrix - Initialize pattern managementnpm run validate - Validate pattern integritynpm run lint - Code lintingnpm run format - Code formattingClone repository:
git clone <repository-url>
cd matrix-mcp-server
Run setup script:
chmod +x setup.sh
./setup.sh
Install dependencies:
npm install
Validate installation:
npm test
npm run validate
Configure Claude MCP:
# Copy configuration to Claude
cp claude_mcp_config.json ~/.claude/mcp_servers.json
# Or merge with existing configuration
cat claude_mcp_config.json >> ~/.claude/mcp_servers.json
Start the server:
npm start
Symptoms: Server not responding, connection timeout Solutions:
node --version (must be >= 18.0.0)npm startnpm installSymptoms: Cell creation fails, validation error messages Solutions:
Symptoms: Sync operations fail, forward-only constraint errors Solutions:
.matrix_pattern/metadata/sync-reports/.matrix_pattern/ directorySymptoms: Cannot read/write matrix files Solutions:
ls -la .matrix_pattern/chmod -R 755 .matrix_pattern/./setup.sh.matrix_pattern/logs/server.log.matrix_pattern/metadata/sync-reports/# Check system status
npm run validate
# Run comprehensive tests
npm test
# Check Node.js version
node --version
# Verify MCP configuration
cat claude_mcp_config.json | jq .
# Check directory structure
ls -la .matrix_pattern/
import { CellValidator } from './src/validator.js';
const customValidator = CellValidator.createValidator({
strict_mode: true,
custom_validators: [
(cellData) => {
if (cellData.content.includes('TODO')) {
return {
errors: [{
type: 'content_quality',
message: 'TODO items not allowed in production cells',
severity: 'high'
}]
};
}
return { valid: true };
}
]
});
// Validate multiple cells
const batchResult = validator.validateBatch([cell1, cell2, cell3]);
console.log(`${batchResult.passed}/${batchResult.total} cells passed validation`);
Create reusable pattern templates for consistent cell structure:
const requirementTemplate = {
content: `# {FEATURE_NAME} Requirements
## Functional Requirements
- TODO: Add functional requirements
## Non-Functional Requirements
- Performance: TODO: Add performance requirements
- Security: TODO: Add security requirements
- Scalability: TODO: Add scalability requirements
## Acceptance Criteria
- TODO: Add acceptance criteria`,
metadata: {
horizontal_type: "requirements",
template_version: "1.0.0"
}
};
git checkout -b feature/amazing-featuregit commit -m 'Add amazing feature'git push origin feature/amazing-featureThis project is licensed under the MIT License - see the LICENSE file for details.
Matrix Pattern System - Organize, synchronize, and scale your development patterns with confidence.
FAQs
Matrix Pattern System MCP Server - Advanced pattern management and synchronization
We found that matrix-pattern demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.