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许可下分发。

📞 支持

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