MCP 服务器

MCP-Kit Developer Task Assignment System

Enables intelligent task assignment to developers using hybrid AI algorithms that match tasks based on past experience, skill sets, workload balance, and project alignment. Features enterprise-grade security with AES-256 encryption and 75% performance optimization through smart caching.

README

MCP-Kit: 개발자 업무 자동 배정 시스템 (최적화 버전) 🚀

MCP (Model Context Protocol) 기반 지능형 개발자-태스크 매칭 시스템

🎯 주요 특징

⚡ 고성능 최적화

75% 응답 시간 단축 (~4초 → ~1초)
99.95% LLM 호출 최적화 (스마트 캐싱)
66% 데이터베이스 쿼리 감소 (N+1 문제 해결)
80% API 비용 절약

🔒 엔터프라이즈급 보안

AES-256 암호화 및 PBKDF2 키 유도
환경변수 검증 및 보안 정책 준수
암호화된 설정 파일 관리
안전한 시크릿 관리

🧠 지능형 배정 알고리즘

하이브리드 AI: 규칙 기반 + LLM 보정
다차원 분석: 과거 경험, 기술 매칭, 업무량, 프로젝트 일치
실시간 학습: 배정 결과 피드백 반영
유사도 기반 매칭: PostgreSQL trigram 유사도

🏗️ 모듈화 아키텍처

확장 가능한 구조: 독립적 모듈로 구성
단일 책임 원칙: 각 모듈의 명확한 역할
높은 재사용성: 모듈별 독립적 사용 가능
테스트 용이성: 모듈별 단위 테스트

기능(요약)

개발자 관리
admin_add_developer - 개발자 등록
get_all_developers - 전체 개발자 목록 조회
업무 관리
admin_add_task - 업무 등록 (자동 배정)
get_all_tasks - 전체 업무 목록 조회
dev_my_tasks - 개발자별 업무 조회
dev_complete_task - 업무 완료 처리
search_similar_tasks - 유사 업무 검색
시스템 관리
seed_demo_data - 데모 데이터 초기화
admin_set_weights - 배정 알고리즘 가중치 설정

분배 규칙

과거 유사 TASK 경험(최대 유사도, 유사 사례 수)
업무량이 적은 순 (편차가 크면 저업무량 개발자 가중)
필요 기술 ∩ 보유 기술 개수
프로젝트 일치 보너스
(옵션) LLM 적합도 보정 (규칙 점수 + LLM 점수 혼합)

유사도는 기본적으로 Postgres pg_trgm(trigram similarity) 사용.
(옵션) OpenAI 임베딩/랭킹 보정 사용 가능.

🔧 환경변수 설정

필수 (PostgreSQL)

PGHOST=localhost
PGPORT=5432
PGDATABASE=mcpdb
PGUSER=postgres
PGPASSWORD=postgres

필수 (Azure OpenAI)

AZURE_OPENAI_ENDPOINT=https://your-endpoint.openai.azure.com/
AZURE_OPENAI_API_KEY=your-api-key-here
AZURE_OPENAI_DEPLOYMENT_NAME=gpt-4o

선택 (OpenAI Fallback)

OPENAI_API_KEY=sk-your-key-here
OPENAI_MODEL=gpt-4o

⚠️ 보안 주의: 실제 API 키는 .env 파일에 설정하고 Git에 커밋하지 마세요.

가상환경 설정

$ uv python install 3.13   
$ uv init
$ uv venv --python 3.13.7
$ source .venv/bin/activate  
$ uv add fastmcp psycopg2-binary openai

Postgres 확장 (서버에서 1회)

CREATE EXTENSION IF NOT EXISTS pg_trgm;

VS Code / Cursor 연결 (.cursor/mcp.json)

Cursor Setting -> MCP & Integrations > MCP Tools 활성화

{
  "mcpServers": {
    "dev-assignment-mcp": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "/절대/혹은/프로젝트/경로",
      "env": {
        "PGHOST": "localhost",
        "PGPORT": "5432",
        "PGDATABASE": "mcpdb",
        "PGUSER": "postgres",
        "PGPASSWORD": "postgres",
        "OPENAI_API_KEY": "sk-... (옵션)",
        "OPENAI_MODEL": "gpt-5",
        "OPENAI_EMBED_MODEL": "text-embedding-3-large"
      }
    }
  }
}