About Mingleai
Mingleai is an MCP server published by kwangilkimkenny in the Developer Tools category: mCP server: Mingleai.
The repository has 1 stars and 0 forks, with the last commit 2 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/kwangilkimkenny/MingleAIThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Mingleai
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
1 check has not been run yet.
README
MingleAI
Another I 소셜 매칭 플랫폼 — AI 에이전트 기반 소셜 매칭 서비스
아키텍처
mingle-ai/
├── packages/
│ ├── shared/ # 공유 TypeScript 타입 (@mingle/shared)
│ └── mcp/ # MCP 서버 (@mingle/mcp)
├── apps/
│ └── backend/ # NestJS REST API (@mingle/backend)
├── docker-compose.yml # PostgreSQL + Redis
└── pnpm-workspace.yaml
기술 스택
- Runtime: Node.js 18+
- Package Manager: pnpm (workspace)
- Backend: NestJS 10, Prisma ORM, PostgreSQL 15
- 인증: JWT + Passport.js (bcrypt)
- MCP Server: @modelcontextprotocol/sdk, better-sqlite3
- API 문서: Swagger (http://localhost:3000/api)
시작하기
사전 요구사항
- Node.js >= 18
- pnpm >= 8
- Docker & Docker Compose
설치
# 의존성 설치
pnpm install
# 환경 변수 설정
cp .env.example apps/backend/.env
# apps/backend/.env에서 DATABASE_URL, JWT_SECRET 수정
# Docker 서비스 기동
docker compose up -d
# DB 마이그레이션
cd apps/backend
npx prisma migrate dev
# 전체 빌드
cd ../..
pnpm build
실행
# 백엔드 개발 서버
pnpm dev:backend
# MCP 서버
pnpm dev:mcp
테스트
cd apps/backend
pnpm test # 전체 테스트
pnpm test:cov # 커버리지 포함
API 엔드포인트
서버 기동 후 http://localhost:3000/api 에서 Swagger UI로 확인 가능합니다.
Auth
| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /auth/register |
회원가입 (email, password) |
| POST | /auth/login |
로그인 → JWT 발급 |
Profiles
| 메서드 | 경로 | 인증 | 설명 |
|---|---|---|---|
| POST | /profiles |
O | 프로필 생성 |
| GET | /profiles |
- | 목록 조회 (필터: location, ageMin, ageMax, relationshipGoal) |
| GET | /profiles/:id |
- | 단일 조회 |
| PATCH | /profiles/:id |
O | 수정 (본인만) |
Parties
| 메서드 | 경로 | 인증 | 설명 |
|---|---|---|---|
| POST | /parties |
O | 파티 생성 |
| GET | /parties/:id |
- | 파티 조회 |
| POST | /parties/:id/participants |
O | 참가 등록 |
| POST | /parties/:id/run |
O | 파티 실행 (테이블 배정 + 매칭) |
| GET | /parties/:id/results |
- | 결과 조회 |
Reports
| 메서드 | 경로 | 인증 | 설명 |
|---|---|---|---|
| POST | /reports/generate |
O | 매칭 리포트 생성 |
| GET | /reports/:id |
- | 리포트 조회 |
| GET | /reports?profileId=xxx |
- | 프로필별 리포트 목록 |
Date Plans
| 메서드 | 경로 | 인증 | 설명 |
|---|---|---|---|
| POST | /date-plans |
O | 데이트 코스 생성 |
| GET | /date-plans/:id |
- | 코스 조회 |
Safety
| 메서드 | 경로 | 인증 | 설명 |
|---|---|---|---|
| POST | /safety/check |
- | 텍스트 안전 검사 |
| POST | /safety/report |
O | 유저 신고 |
Health
| 메서드 | 경로 | 설명 |
|---|---|---|
| GET | /health |
헬스체크 |
DB 스키마
7개 모델: User, Profile, Party, PartyParticipant, Report, DatePlan, SafetyReport
# Prisma Studio로 DB 탐색
cd apps/backend
npx prisma studio
스크립트
| 명령어 | 설명 |
|---|---|
pnpm build |
전체 빌드 |
pnpm dev:backend |
백엔드 개발 서버 |
pnpm dev:mcp |
MCP 서버 |
pnpm lint |
ESLint |
pnpm clean |
dist 정리 |
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
DATABASE_URL |
PostgreSQL 연결 문자열 | - |
JWT_SECRET |
JWT 서명 키 | - |
PORT |
서버 포트 | 3000 |
README fetched from the repository 7 days ago. The original is authoritative.