A comprehensive security sanitization library for Model Context Protocol (MCP) servers, designed to prevent common attack vectors including command injection, SQL injection, directory traversal, prototype pollution, and code execution attempts.
Comprehensive security sanitization library for Model Context Protocol (MCP) servers with trusted security libraries
While we maintain rigorous security standards and comprehensive test coverage, we acknowledge that:
No security solution is 100% bulletproof against unknown threats
Zero-day vulnerabilities may emerge in the future
Defense-in-depth is essential (use multiple security layers)
Regular updates are crucial for evolving threat landscape
We encourage responsible disclosure of any security issues via GitHub Security Advisories.
Installation
npm install mcp-sanitizer
Quick Start
const MCPSanitizer = require('mcp-sanitizer');
// Use default configuration
const sanitizer = new MCPSanitizer();
// Or use a security policy
const strictSanitizer = new MCPSanitizer('STRICT');
// Sanitize MCP tool call
const toolCall = {
name: "file_reader",
parameters: {
file_path: "../../../etc/passwd" // Malicious input
}
};
const result = sanitizer.sanitize(toolCall);
if (result.blocked) {
console.log('Attack blocked:', result.warnings);
} else {
console.log('Safe input:', result.sanitized);
}
Security Policies
The MCP Sanitizer includes five pre-configured security policies:
Policy
Use Case
String Limit
Protocols
Blocking Level
STRICT
High-security, untrusted input
1,000 chars
HTTPS only
Medium+
MODERATE
Balanced production security
5,000 chars
HTTP, HTTPS, MCP
High+
PERMISSIVE
Trusted environments
50,000 chars
HTTP, HTTPS, FTP, MCP, File
Critical only
DEVELOPMENT
Development with debugging
20,000 chars
HTTP, HTTPS, MCP, File
High+
PRODUCTION
Production environments
8,000 chars
HTTPS, MCP
High+
// Use a security policy
const sanitizer = new MCPSanitizer('PRODUCTION');
// Use policy with customizations
const customSanitizer = new MCPSanitizer({
policy: 'MODERATE',
maxStringLength: 15000,
allowedProtocols: ['https', 'mcp'],
blockOnSeverity: 'medium' // Block medium severity and above
});
Framework Middleware
Express.js
const express = require('express');
const { createExpressMiddleware } = require('mcp-sanitizer/middleware/express');
const app = express();
app.use(express.json());
// Apply middleware with defaults
app.use(createExpressMiddleware());
// Or specify configuration
app.use(createExpressMiddleware({
policy: 'PRODUCTION',
mode: 'sanitize', // or 'block'
skipPaths: ['/health', '/metrics'] // Skip sanitization for these paths
}));
app.post('/tools/:toolName/execute', (req, res) => {
// req.body is now sanitized
// req.sanitizationWarnings contains any warnings
});
Prototype Pollution - Proto/constructor manipulation, deep property injection
Template Injection - Server-side template engines, JNDI lookups, expression languages
Code Execution - Dynamic evaluation, module loading, function constructors
API Reference
new MCPSanitizer(options?)
Create a new sanitizer instance.
Parameters:
options: Configuration object, security policy name, or policy with customizations
sanitizer.sanitize(input, context?)
Sanitizes input data and returns a result object.
Parameters:
input: The data to sanitize (any type)
context: Optional context object with type field
Returns:
{
sanitized: any, // Sanitized data (null if blocked)
warnings: string[], // Array of warning messages
blocked: boolean // True if input was blocked
}
Context Types:
file_path: Apply file path validation
url: Apply URL validation
command: Apply command validation
sql: Apply SQL query validation
Specialized Methods
// Sanitize specific input types
sanitizer.sanitizeFilePath('/path/to/file');
sanitizer.sanitizeURL('https://example.com');
sanitizer.sanitizeCommand('ls -la');
sanitizer.sanitizeSQL('SELECT * FROM users WHERE id = ?');
If you discover a security vulnerability, please email me instead of using the public issue tracker. We follow responsible disclosure practices and will credit researchers.