Kyc Docx MCP 191125

MexKYC-基于人工智能的墨西哥KYC

了解你的客户。了解墨西哥。

](https://www.npmjs.com/package/@mexkyc/mcp) 

网站 • 文档 • api参考

______________________________________________________________________

🇲🇽 什么是MexKYC？

MexKYC 公司 是一个生产就绪的人工智能KYC（了解你的客户）文档提取平台，专为墨西哥商业文档设计。作为MCP（模型上下文协议）服务器构建，它与AI助手和自动化工作流程无缝集成。

从墨西哥监管文件中提取结构化数据，构建统一的客户档案，验证合规要求，并生成全面的KYC报告——所有这些都具有人工智能的精度。

✨ 特性

• 🔍 多文档支持 -从7+种墨西哥商业文档中提取数据
• 🤖 人工智能驱动的提取 -使用先进的视觉模型进行精确的OCR和数据提取
• 📊 智能聚合 -从多个文档来源构建统一的KYC档案
• 🏠 智能地址解析 -智能地址优先级逻辑（财政、运营和历史）
• ✅ 验证引擎 -通过评分和风险标记进行全面验证
• 🔌 MCP协议 -标准化的模型上下文协议，便于人工智能集成
• 📝 类型安全 -带有Zod模式验证的完整TypeScript
• 🔐 企业就绪 -多租户、审计日志记录和合规性功能

📄 支持的文档类型

🏗️ 建筑

┌─────────────────────┐
│   AI Assistant      │  (ChatGPT, Claude, Custom)
│   or MCP Client     │
└──────────┬──────────┘
           │
           ▼
┌─────────────────────┐
│   MexKYC MCP        │  ← @mexkyc/mcp
│   Server            │
└──────────┬──────────┘
           │
    ┌──────┴──────┬──────────┬──────────┬──────────┐
    ▼             ▼          ▼          ▼          ▼
┌────────┐  ┌──────────┐ ┌────────┐ ┌────────┐ ┌────────┐
│Extract │  │Build     │ │Validate│ │Report  │ │Storage │
│Docs    │  │Profile   │ │        │ │        │ │        │
└────────┘  └──────────┘ └────────┘ └────────┘ └────────┘
    │
    ▼
┌─────────────────────┐
│  Document           │
│  Extractors         │  ← AI Vision Models
└─────────────────────┘

🚀 快速开始

先决条件

• Node.js 20+
• TypeScript 5.5+
• API密钥（OpenAI或Google Gemini）

安装

# Install from npm
npm install @mexkyc/mcp

# Or clone the repository
git clone https://github.com/mexkyc/mexkyc-mcp.git
cd mexkyc-mcp
npm install

配置

创建一个 .env 文件：

# AI Model (choose one)
OPENAI_API_KEY=your_openai_api_key
# OR
GOOGLE_API_KEY=your_gemini_api_key

# Optional: Server configuration
PORT=3000
MCP_TRANSPORT=sse  # 'sse' for HTTP, omit for stdio

运行服务器

# Development mode
npm run dev

# Production build
npm run build
npm run start

# Run MCP server directly
npx mexkyc

📡 MCP工具API

MexKYC公开了5个用于文档处理的MCP工具：

1. list_supported_doc_types

列出所有支持的墨西哥文档类型。

// No parameters required
const result = await mcpClient.callTool("list_supported_doc_types", {});

2. import_kyc_document

从KYC文档中导入和提取数据。

await mcpClient.callTool("import_kyc_document", {
  customer_id: "empresa-xyz",
  doc_type: "sat_constancia",
  file_url: "https://storage.example.com/constancia.pdf",
  source_name: "SAT_2024.pdf"  // optional
});

3. build_kyc_profile

将所有导入的文件聚合到一个统一的KYC配置文件中。

await mcpClient.callTool("build_kyc_profile", {
  customer_id: "empresa-xyz"
});

4. validate_kyc_profile

验证KYC档案并生成合规评分。

await mcpClient.callTool("validate_kyc_profile", {
  customer_id: "empresa-xyz"
});

5. get_kyc_report

生成一份综合的KYC报告，结合个人资料和验证。

await mcpClient.callTool("get_kyc_report", {
  customer_id: "empresa-xyz",
  include_trace: true  // optional: include extraction details
});

💡 用法示例

// Complete KYC workflow
const customerId = "mi-empresa-sa";

// 1. Import SAT Constancia (tax certificate)
await import_kyc_document({
  customer_id: customerId,
  doc_type: "sat_constancia",
  file_url: "https://example.com/constancia.pdf"
});

// 2. Import Acta Constitutiva (incorporation deed)
await import_kyc_document({
  customer_id: customerId,
  doc_type: "acta",
  file_url: "https://example.com/acta.pdf"
});

// 3. Import proof of address
await import_kyc_document({
  customer_id: customerId,
  doc_type: "cfe",
  file_url: "https://example.com/cfe_bill.pdf"
});

// 4. Build unified profile
await build_kyc_profile({ customer_id: customerId });

// 5. Validate for compliance
await validate_kyc_profile({ customer_id: customerId });

// 6. Generate KYC report
const report = await get_kyc_report({ customer_id: customerId });

🏠 地址解析逻辑

MexKYC实现智能地址解析：

🔒 安全与合规

• 多租户隔离 -组织级数据分离
• 审核日志记录 -完整的合规审计跟踪
• API密钥验证 -安全的API访问
• 速率限制 -防止虐待
• 需要HTTPS -加密数据传输

📁 项目结构

src/
├── extractors/          # Document-specific AI extractors
│   ├── actaCompanyIdentity.ts
│   ├── companyTaxProfileExtractor.ts
│   ├── ineIdentity.ts
│   ├── fm2Immigration.ts
│   ├── telmexProofOfAddress.ts
│   ├── cfeProofOfAddress.ts
│   └── bankStatementProfile.ts
├── kyc/                 # Core KYC logic
│   ├── types.ts         # Domain types
│   ├── profileBuilder.ts
│   ├── validation.ts
│   └── reportBuilder.ts
├── mcp/                 # MCP server implementation
│   ├── server.ts        # Main server with tool handlers
│   └── cli.ts           # CLI entry point
├── schemas/             # Zod schemas
│   └── mx/              # Mexican document schemas
└── utils/               # Utilities

🧪 测试

# Run all tests
npm test

# Test specific extractors
npm run test:constancia   # SAT Constancia
npm run test:acta         # Acta Constitutiva
npm run test:cfe          # CFE bills
npm run test:bank         # Bank statements

# End-to-end KYC tests
npm run test:kyc-pfds
npm run test:kyc-report-pfds

🤝 贡献

1. 复刻仓库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

ISC许可证-请参阅 许可证 了解详情。

🔗 链接

• 网站: https://mexkyc.com
• 文档: https://docs.mexkyc.com
• api参考: https://api.mexkyc.com/docs
• GitHub:
• npm:

💬 支持

• 问题:
• 电子邮件: support@mexkyc.com
• 推特: @ 墨西哥

______________________________________________________________________

内置于❤️ 墨西哥金融科技生态系统

*MexKYC-了解你的客户。了解墨西哥。*