3elements-mcp-server

一个提供银行卡三要素和运营商三要素验证服务的 MCP (Model Context Protocol) 服务器。

🚀 快速开始

安装

npm install -g @alouhaou/3elements-mcp-server

配置环境变量

在使用前，你需要配置以下环境变量：

export CHENGHE_APPID="your_app_id"
export CHENGHE_SECRET="your_secret_key"

启动服务

3elements-mcp-server

📋 功能说明

银行卡三要素验证

验证银行卡号、身份证号和姓名是否匹配。

使用场景：

• 银行卡开户验证
• 支付安全验证
• 金融风控

运营商三要素验证

验证手机号、身份证号和姓名是否匹配。

使用场景：

• 手机号实名认证
• 运营商业务办理
• 身份信息核验

笔记管理

创建和管理文本笔记。

使用场景：

• 临时信息记录
• 测试和演示

🔧 工具调用

银行卡三要素验证

{
  "tool": "verifyBankCard3",
  "arguments": {
    "name": "张三",
    "idcard": "110101199001011234",
    "bankcard": "6222021234567890123"
  }
}

参数说明：

• name (string): 持卡人姓名
• idcard (string): 身份证号码
• bankcard (string): 银行卡号

运营商三要素验证

{
  "tool": "verifyMobileThree",
  "arguments": {
    "name": "张三",
    "idcard": "110101199001011234",
    "mobile": "13800138000"
  }
}

参数说明：

• name (string): 机主姓名
• idcard (string): 身份证号码
• mobile (string): 手机号码

创建笔记

{
  "tool": "create_note",
  "arguments": {
    "title": "测试笔记",
    "content": "这是一个测试笔记的内容"
  }
}

参数说明：

• title (string): 笔记标题
• content (string): 笔记内容

📊 返回结果

服务会返回橙禾 API 的原始响应数据，格式为 JSON 字符串。具体返回格式取决于橙禾 API 的响应结构。

示例响应

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"code\": 200,\n  \"message\": \"验证成功\",\n  \"data\": {\n    \"result\": \"1\",\n    \"message\": \"验证通过\",\n    \"name\": \"张三\",\n    \"idcard\": \"110101199001011234\",\n    \"bankcard\": \"6222021234567890123\"\n  }\n}"
    }
  ]
}

注意： 返回的 text 字段包含的是 JSON 字符串，需要解析后才能获取具体的验证结果。

⚠️ 注意事项

数据安全

• 🔒 所有验证数据均通过加密传输
• 🛡️ 不会存储任何用户个人信息
• 🔐 建议在 HTTPS 环境下使用

使用限制

• 📊 请确保输入的数据格式正确
• ⏱️ 单次验证响应时间通常在 1-3 秒
• 🔄 建议实现适当的重试机制

错误处理

• ❌ 网络异常：检查网络连接
• 🔑 认证失败：检查 AppID 和 Secret 配置
• 📝 参数错误：检查输入参数格式

🌐 集成示例

在 Claude Desktop 中使用

在 Claude Desktop 的配置文件中添加：

{
  "mcpServers": {
    "3elements-mcp-server": {
      "command": "npx",
      "args": ["@alouhaou/3elements-mcp-server"],
      "env": {
        "CHENGHE_APPID": "your_app_id",
        "CHENGHE_SECRET": "your_secret_key"
      }
    }
  }
}

在 Cursor 中使用

在 Cursor 的 MCP 配置中添加：

{
  "mcpServers": {
    "3elements-mcp-server": {
      "command": "npx",
      "args": ["@alouhaou/3elements-mcp-server"],
      "env": {
        "CHENGHE_APPID": "your_app_id",
        "CHENGHE_SECRET": "your_secret_key"
      }
    }
  }
}

🆘 常见问题

Q: 如何获取 AppID 和 Secret？

A: 请联系橙禾 API 服务提供商获取相应的认证信息。

Q: 验证失败的原因有哪些？

A: 常见原因包括：

• 姓名与身份证不匹配
• 银行卡号与身份证不匹配
• 手机号与身份证不匹配
• 输入信息格式错误

Q: 服务支持哪些银行卡？

A: 支持国内主要银行的储蓄卡和信用卡。

Q: 如何提高验证成功率？

A: 确保输入的信息准确无误，特别是姓名要与身份证上的完全一致。

📞 技术支持

如果你在使用过程中遇到问题，可以：

1. 检查环境变量配置是否正确
2. 确认网络连接是否正常
3. 验证输入参数格式是否正确
4. 联系技术支持团队

📚 开发者文档

如果你是开发者，想要了解如何部署、开发或贡献代码，请查看 DEVELOPMENT.md 文档。

📄 许可证

MIT License

免责声明： 本服务仅提供信息验证功能，不承担因验证结果产生的任何法律责任。请在使用前确保符合相关法律法规要求。