@ekaone/mcp-tools

Under Active Development

MCP (Model Context Protocol) server exposing @ekaone utility tools for AI-assisted data masking via stdio transport.

Tools

Tool	Package	Description
mask_card	@ekaone/mask-card	Masks credit/debit card numbers (PCI DSS compliant)
mask_email	@ekaone/mask-email	Masks email addresses for privacy protection

Usage

1. With MCP Clients (Windsurf, Cursor, VS Code, Claude Desktop)

Add this configuration to your MCP client:

{
  "mcpServers": {
    "masker": {
      "command": "npx",
      "args": [
        "@ekaone/mcp-tools@latest"
      ]
    }
  }
}

2. With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "masker": {
      "command": "npx",
      "args": [
        "@ekaone/mcp-tools@latest"
      ]
    }
  }
}

Then just talk to Claude naturally:

"Hide all card numbers in this table"
"Mask the email john.doe@example.com"
"Show only last 4 digits of this card: 4532-1234-5678-9012"

3. Available Commands

Once connected, you can use these commands:

• Mask email addresses: "Can you mask this email: user@domain.com?"
• Mask card numbers: "Please mask this credit card: 4532-1234-5678-9012"
• Custom masking: "Mask this card showing only first 4 digits: 4532-1234-5678-9012"

Tool Reference

mask_card

Parameter	Type	Required	Default	Description
value	string	✅	—	Card number to mask
maskChar	string	❌	*	Masking character
unmaskedStart	number	❌	0	Digits visible at start
unmaskedEnd	number	❌	4	Digits visible at end

Examples:

Input : "4532-1234-5678-9012"
Output: "************9012"

Input : "4532-1234-5678-9012", unmaskedStart: 4
Output: "4532********9012"

Input : "4532-1234-5678-9012", maskChar: "•"
Output: "••••••••••••9012"

mask_email

Parameter	Type	Required	Default	Description
email	string	✅	—	Email address to mask
maskChar	string	❌	*	Masking character
visibleChars	number	❌	2	Characters visible at start
maskDomain	boolean	❌	false	Also mask the domain

Examples:

Input : "john.doe@example.com"
Output: "jo******@example.com"

Input : "john.doe@example.com", visibleChars: 4
Output: "john**@example.com"

Input : "john.doe@example.com", maskDomain: true
Output: "jo******@e******.com"

Local Development

# Install dependencies
pnpm install

# Development with hot reload
pnpm dev

# Run tests
pnpm test

# Build for production
pnpm build

# Test the built package locally
pnpm start

Testing Locally

Test the MCP server locally:

# Build first
pnpm build

# Test stdio communication
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

Publishing

# Build and test before publishing
pnpm run prepublishOnly

# Publish to NPM
pnpm publish

Branch Structure

This repository has two main branches:

• stdio (current branch) - For stdio MCP client usage (this README)
• HTTP/SSE - For HTTP/SSE endpoint deployment

License

MIT © Eka Prasetia

Links

• npm Package
• GitHub Repository
• Issue Tracker

---

⭐ If this library helps you, please consider giving it a star on GitHub!