@ekaone/mcp-tools

Under Active Development

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

npm version License: MIT TypeScript

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

Links

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

ekaone/mcp-tools