AI导哈

企业注册信息验证服务

提供企业注册号码真实性验证及信息查询的REST API服务，支持MCP协议和公共数据门户API集成。

  • by bamin0422
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 bamin0422/mcp_business_check_server

使用说明

MCP业务检查服务器

运营商注册号真伪和信息查询模型上下文协议（MCP）服务器。

🏗️ 体系结构

这个项目 MVC（模型-视图-控制器） 使用阵列进行结构化：

src/
├── models/          # 데이터 모델 정의
├── services/        # 비즈니스 로직
├── controllers/     # 요청/응답 처리
├── middleware/      # 미들웨어 (인증, 검증, 로깅)
├── routes/          # 라우터 정의
├── utils/           # 유틸리티 함수
└── server.ts        # 메인 애플리케이션

🚀 功能

MCP工具

  • check_business_number：确认运营商注册号真伪并查询信息
  • register_api_key：注册公共数据门户API验证密钥

REST API端点

  • GET /：API信息
  • GET /health：检查服务器状态
  • POST /register-key：注册验证密钥
  • GET /check-business/:bizNumber：确认运营商注册号

📋 要求

  • Node.js 18+
  • pnpm
  • 公共数据门户API验证密钥

🛠️ 安装和运行

本地开发

# 의존성 설치
pnpm install

# TypeScript 빌드
pnpm build

# 개발 모드 실행 (Express + MCP)
pnpm start

# MCP 전용 모드 실행
MCP_SERVER=true pnpm start

运行Docker

# Docker 이미지 빌드
docker build -t mcp-business-check-server .

# Docker 컨테이너 실행
docker run -it mcp-business-check-server

🔧 设置

环境变量

  • PORT：Express服务器端口（默认值：3000）
  • MCP_SERVER：启用仅MCP模式（true/false）
  • NODE_ENV：执行环境（development/production）

注册验证密钥

# REST API로 등록
curl -X POST http://localhost:3000/register-key \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "your-api-key-here"}'

# MCP 도구로 등록
# register_api_key 도구 사용

🧪 测试

# API 정보 확인
curl http://localhost:3000/

# 헬스체크
curl http://localhost:3000/health

# 사업자등록번호 확인
curl http://localhost:3000/check-business/2208102810

🚀 Smithery AI배포

这个项目 Smithery AI配置为在中部署。

分发文件

  • Dockerfile：设置Docker容器构建
  • smithery.yaml：Smithery AI部署设置
  • .dockerignore：构建Docker时排除的文件

主要修改

  1. 分离stdout/stderr：避免与MCP JSON-RPC协议冲突
  2. 支持环境变量：正确处理PORT环境变量
  3. 仅MCP模式：Express服务器禁用选项

📁 项目结构

Models（模型）

  • BusinessInfo.ts：运营商信息接口
  • Config.ts：设置相关界面

服务（Services）

  • BusinessCheckService.ts：确认运营商注册号业务逻辑
  • ConfigService.ts：管理设置
  • MCPService.ts：MCP服务器管理

Controllers（控制器）

  • BusinessController.ts：处理与运营商相关的请求
  • ConfigController.ts：处理与设置相关的请求
  • HealthController.ts：处理健康检查请求

Middleware（中间件）

  • auth.ts：认证处理
  • validation.ts：验证输入
  • common.ts：CORS、日志记录、错误处理

Routes（路由器）

  • business.ts：运营商相关路由器
  • config.ts：与设置相关的路由器
  • health.ts：健康检查路由器

Utils（实用程序）

  • errors.ts：自定义错误类
  • validators.ts：验证函数

🔍 API响应示例

运营商注册号码确认响应

{
  "isValid": true,
  "businessName": "테스트 기업",
  "ownerName": "홍길동",
  "address": "서울시 강남구",
  "status": "국세청에 등록된 사업자입니다.",
  "raw": {
    "b_no": "2208102810",
    "b_stt": "계속사업자",
    "tax_type": "국세청에 등록된 사업자입니다."
  },
  "timestamp": "2025-07-20T04:13:28.985Z",
  "requestId": "vla2g0r4y"
}

🤝 贡献

  1. 分叉项目
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支机构(git push origin feature/AmazingFeature)
  5. 打开拉取请求

📄 许可证

该项目在MIT许可下分发。

📞 支持

如果出现问题或有问题，请生成问题。

相关 MCP