Redactor MCP

编者mcp

MCP服务器，封装AWS Comprehend以进行PII检测和编辑。在Claude Desktop中上传一个纯文本文件，要求它删除PII，并返回一个经过编辑的版本。

这是一个 演示工程不是生产软件。

先决条件

• Node.js 18+或Bun 1.0+
• AWS凭据 comprehend:DetectPiiEntities 和 comprehend:DetectDominantLanguage 权限

AWS凭据设置

选项A:AWS访问门户（SSO）

aws configure sso
# Profile name: your-profile
# SSO start URL: https://your-org.awsapps.com/start
# SSO region: us-east-1
# Account and role: select from browser

aws sso login --profile your-profile
export AWS_PROFILE=your-profile

选项B：静态凭据

aws configure
# Enter Access Key ID, Secret Access Key, region (us-east-1)

所需IAM权限

{
  "Effect": "Allow",
  "Action": [
    "comprehend:DetectPiiEntities",
    "comprehend:DetectDominantLanguage"
  ],
  "Resource": "*"
}

安装

bun install

类型检查

bun run typecheck

建筑

构建项目以 dist/:

bun run build

运行服务器

发展：

bun run dev

生产（建造后）：

bun run start

MCP检验员测试

启动Inspector UI以交互方式测试工具：

bun run inspector

1. 点击 连接
2. 首选 工具 选项卡，单击 列出工具
3. 测试工具：

语言检测

{"text": "Bonjour, je m'appelle Marie."}

返回检测到的语言及其置信度得分：

[
  {
    "language_code": "fr",
    "language_name": "French",
    "score": 0.9876
  }
]

PII检测

测试 detect_pii 与： {"text": "My name is Jane Doe and my SSN is 123-45-6789."}

返回两个实体：NAME（“Jane Doe”）和SSN（“123-45-6789”）

PII补救措施

测试 redact_pii 文本相同

退货： "My name is [NAME] and my SSN is [SSN]."

语言支持

• 语言检测：支持100多种语言
• PII检测/补救：目前支持 英语和西班牙语 仅

您可以选择指定语言代码：

{"text": "Mi nombre es Juan García", "language_code": "es"}

或者让系统自动检测：

{"text": "My name is Jane Doe"}

备注：如果向PII工具提供非英语/非西班牙语文本，您将收到一条明确的错误消息，其中包含检测到的语言。

Claude桌面配置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

选项1：开发模式（从源代码运行）

{
  "mcpServers": {
    "redactor-mcp": {
      "command": "bun",
      "args": ["run", "/absolute/path/to/redactor-mcp/src/index.ts"],
      "env": {
        "AWS_PROFILE": "your-profile",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

选项2：生产模式（运行编译版本）

{
  "mcpServers": {
    "redactor-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/redactor-mcp/dist/index.js"],
      "env": {
        "AWS_PROFILE": "your-profile",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

重要提示： 替换：

• /absolute/path/to/redactor-mcp 这个项目的实际路径
• your-profile 使用您的AWS配置文件名

对于生产模式，请确保运行 bun run build 第一。

分销包装

创建MCPB包以便于分发：

bun run pack

这创建了一个 .mcpb 可以直接安装在Claude Desktop中的文件。

用法

上传a .txt, .md，或 .csv 在Claude Desktop中打开文件，然后尝试以下提示：

• “这份文件是什么语言的？”
• “检测此文件中的语言”
• “检测此文件中的PII”
• “从此文件中删除PII”（自动检测语言）
• “查找此文件中的所有电子邮件地址”
• “仅修改姓名和电话号码”
• “Redact PII，但只有高置信度匹配”
• “使用西班牙语代码检测PII”

示例文件位于 docs/samples/ 用于测试：

• sample-001.md -带PII的英文文本
• sample-002.csv -英文CSV，包含多条员工记录
• sample-003-spanish.txt -带有PII的西班牙语文本（测试西班牙语PII检测）
• sample-004-french.txt -法语文本（测试语言检测和不支持的语言处理）