MCP服务器
用于实现业务自动化的模型上下文协议（MCP）服务器。
支持Claude等AI代理直接调用消息发送、文件转换、Java代理诊断等业务工具。
实施的MCP工具
发送消息
| 工具 |
说明 |
message_send |
在通道特定的tran表中加载消息发送请求（SMS/MMS/KKO/RCS） |
message_get_result |
在msgId和发送日期查询发送结果单件 |
message_search |
搜索多条件发送结果（日期/接收号码/频道/状态+页面） |
message_find_failures |
查看过滤失败的次数+按resultCode分类的次数摘要 |
message_result_code_explain |
将通信公司的结果代码解释为人可以阅读的原因 |
message_check_pending |
在等待/处理期间按频道查询状态件数+长期滞留警告 |
message_retry |
失败时返回重新发送队列（指定msgIds或条件） |
message_cancel |
取消取消未发送（等待）状态（指定msgIds或groupId） |
message_stat_summary |
统计历史发送统计（按渠道/按时间段/按天groupBy） |
message_diagnose_failures |
自动诊断故障模式分析和推测原因 |
message_daily_report |
生成特定日期发送的综合报告 |
message_weekly_report |
每周发送报告（7天趋势，环比增减率） |
message_channel_breakdown |
按频道分解详细类型的统计信息 |
message_delivery_time_stats |
接收所需时间分布直方图 |
message_trend_compare 比较两个期间的发货统计信息 |
|
文件转换
| 工具 |
说明 |
file_fransform_md_to_docx |
Markdown→DOCX转换（自动应用清晰的哥特式风格） |
file_transform_md_to_pdf |
Markdown→PDF转换（清晰的哥特式+目录链接） |
file_generate_image |
创建指定大小的示例图像（背景色/文本/格式设置） |
Java代理诊断
| 工具 |
说明 |
agent_analyze_config |
setting.cmd/sh、agent.conf、jdbc.conf解析和摘要 |
agent_analyze_logs |
logs/目录扫描-ERROR/WARN分类和原因提取 |
agent_diagnose |
综合分析设置+日志+文件是否存在，返回问题和建议措施 |
agent_test_db |
基于jdbc.conf测试实际数据库连接 |
agent_insert_sample |
指定表格中的示例消息INSERT（用于发送测试） |
agent_diagnose检测项目
类别类型说明
|----------|------|------|
| DB_CONNECTION_FAILED 日志检测DB连接失败
| TABLE_NOT_FOUND |日志|无表检测|
| RELAY_CONNECTION_FAILED |日志|检测到中继服务器连接失败|
| JVM_MEMORY |日志|检测JVM内存不足|
| CLASSPATH_ERROR |日志|检测类加载失败（JAR路径错误等）|
| NO_ACTIVE_MESSAGE_TYPE |设置| smsUse/lmsUse/mmsUse/kkoUse全部禁用|
| JAVA_HOME_MISSING |设置|未设置JAVA_HOME |
| UNKNOWN_DB_TYPE |设置|无法识别DB类型|
| JAVA_EXECUTABLE_NOT_FOUND |文件|没有java.exe路径|
| JAR_NOT_FOUND |文件| JAR_PATH中没有jar文件|
| MAPPER_NOT_FOUND |文件|没有mapper XML文件|
执行
# 개발 (tsx로 직접 실행)
npx tsx mcp-stdio.ts
项目结构
mcp-stdio.ts # 서버 진입점 (stdio transport)
mcp/
├── registry.ts # 모듈 등록 및 도구 라우팅
├── types.ts # 공통 타입 정의
├── utils.ts # 파라미터 파싱 유틸
└── tools/
├── agent.ts # Java 에이전트 진단 도구
├── message.ts # 메시지 발송 도구
└── file.ts # 파일 변환 도구
feature/
├── agent/ # Java 에이전트 진단
│ ├── dto.ts
│ ├── shared.ts
│ ├── parsers/
│ ├── analyze-config.service.ts
│ ├── analyze-logs.service.ts
│ ├── diagnose.service.ts
│ ├── test-db.service.ts
│ └── insert-sample.service.ts
├── message/ # 메시지 발송·조회·통계
│ ├── dto.ts
│ ├── shared.ts
│ ├── send.service.ts
│ ├── get-result.service.ts
│ ├── search.service.ts
│ └── ... (15개 서비스)
└── file/ # 파일 변환
├── dto.ts
├── shared.ts
├── md-to-docx.service.ts
├── md-to-pdf.service.ts
└── generate-image.service.ts
lib/
└── prisma.ts # Prisma 클라이언트
prisma/
└── schema.prisma # DB 스키마
